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PREFACE 


This  volume  is  one  of  a series  which  documents  a .Search  and 
Rescue  Simulation  Model  for  the  United  States  Coast  Guard.  The 
material  reported  in  this  documentation  was  developed  by  an  inter- 
disciplinary team  at  the  National  Bureau  of  Standards  with  representa- 
tion from  the  U.S.  Coast  Guard  under  Ml PR.  Z-70Q99-0-01935. 

The  complete  documentation  is  comprised  of  the  following: 

Volume  I Executive  Level  Documentation 

Volume  II  Analyst  Level  Documentation 

Volume  III  Programmer  Level  Documentation  for  "PREPROCESSOR" 

Volume  TV  Programmer  Level  Documentation  for  "OPSIM" 

Volume  V Programmer  Level  Documentation  for  "POSTPROCESSOR" 

Appendix  A Flow  Charts  for  Programmer  Level  Documentation 
Appendix  B Program  Listings  for  Programmer  Level  Documentation 
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I . Computer  Program  Listing  for  OPSIM 


Computer  listings  for  OPSIM  are  found 
in  Appendix  B (NBS  Report  No.  10436). 
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II.  Definition  Deck 


Every  Temporary  Entity,  Event  Notice,  Permanent  Entity,  Attribute, 
and  Set  must  be  described  in  the  Definition  Deck.  A sample  coding  form 
for  the  Definition  Deck  is  shown  in  Figure  II-l.  A listing  of  the 
Definition  Deck  used  for  OPSIM  is  included  with  the  program  listing 
For  a detailed  description  of  the  Definition  Deck  preparation, 
the  reader  is  referred  to  SIMSCRIPT  A Simulation  Programming  Language 
by  Markowitz,  Hausner  and  Karr,  Prentice -Hal 1 , Inc.,  1963. 

Special  mention  should  be  made  of  the  manner  in  which  attributes 
are  stored  and  packed.  Packing  allows  more  than  one  attribute  to 
occupy  a single  word  of  computer  storage.  This  is  necessary  in  order  to 
accommodate  in  core  storage  the  large  amount  of  information  utilized 
by  the  simulation.  Care  must  be  taken,  however,  that  the  size  of  the 
stored  attribute  does  not  exceed  the  maximum  allowable  size  for  the 
packing  code.  It  should  be  further  noted  that  time  information  must  be 
stored  as  floating  point  days.  For  maximum  possible  accuracy,  all 
attributes  which  contain  specific  times  (not  durations)  and  other 
critical  values  should  be  stored  in  full  words.  The  maximum  size  for 
several  packing  codes  is  shown  in  Figure  1 1 - 2 below.  This  is  an  amended 
version  of  Table  2 found  on  page  107  of  the  above  references.  It  should 
be  noted  that  one-sixth  (1/6)  packing  is  also  allowed  for  the  UNIVAC  1108 
system,  but  since  it  is  not  universally  available,  it  has  not  been  used 
for  OPSIM. 

For  attributes  of  Permanent  Entities  the  packing  code  is  in 
column  44  of  the  Definition  Card.  For  example  the  listing  of  the 
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FIGURE  II 


definition  deck  in  the  computer  program  listings  shows  the  attribute  COST 
being  packed  two  to  a word  and  the  attribute  SIN  being  packed  four  to  a word. 

The  attributes  of  temporary  entities  are  stored  in  a different 
manner.  Associated  with  each  temporary  entity  are  a "Master  Record" 
and  possibly  several  'Satellite  Records".  The  number  of  words  in  the 
Master  Record  is  found  in  column  9 and  the  number  of  words  in  each 

succeeding  Sattelite  Record  follows  in  columns  10  through  17.  There 
can  be  at  most  eight  words  per  record.  A particular  word  of  any  record 
may  contain  more  than  one  different  attribute.  The  storage  code  appears 
in  columns  25  and  26  with  the  packing  in  columns  27-29.  For  example,  the 
computer  listing  of  the  definition  deck  shows  the  CASE  attribute  COUNT  with 
code  123/4  indicating  that  it  is  stored  in  the  third  quarter  of  the  second 
word  in  the  first  satellite  record.  A zero  or  blank  in  column  25 
indicates  the  master  record.  Two  or  more  temporary  entities  and  event 
notices  may  have  attributes  of  the  same  name  if  that  attribute  occupies 
the  same  relative  storage  position.  In  this  case  the  attribute  name 
appears  in  the  Definition  Deck  with  only  one  of  the  temporary  entities 
or  event  notices.  A pictorial  map  of  the  storage  layout  for  CASE,  NOTE, 

NOTIF,  and  FLT  is  given  below.  The  other  event  notices  have  short 
records  and  will  not  be  mapped  herein. 

It  should  be  noted  that  storage  and  retrieval  times  are  somewhat 
greater  for  packed  attributes  than  for  unpacked  ones , and  also  greater 
for  attributes  stored  in  Satellite  Records  than  those  in  the  Master 
Record . 
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B.  The  Event  Notice  NOTIF 
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D.  The  Temporary  Entity  FLT 
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III.  OPSIM  Subroutines  and  Event  Routines 


A.  Brief  description  of  each  routine: 

1 . Exogenous  Event  START  occurs  at  TIME  = 0.0,  The  system  attribute 
LIMIT  is  calculated.  The  station,  resource  type,  X coordinate  and  Y 
coordinate  of  all  resources  are  set.  A Saturday  indicator,  ISA,  and 

a Monday  indicator,  IMO  are  calculated  using  IFDAY,  the  first  day  of 
the  simulation.  PSHFT,  the  present  shift,  is  set  after  checking 
IFDAY  and  the  possibility  that  the  first  day  may  be  a holiday.  The 
first  crew  change,  the  first  sunrise  and  the  first  sunset  are  created 
and  caused  to  occur  at  the  appropriate  future  times . 

2.  Endogenous  Event  NUCRU  occurs  when  there  is  a change  of  shift. 
Utilization  data  is  accumulated  for  TUTIL,  UTIL,  USHF  and  CLLCT. 

If  it  is  the  last  shift  change  of  the  day,  weekend  or  weekday  daily 
utilization  statistics  are  also  collected.  PSHFT  is  updated  and  an 
event  notice  for  another  NUCRU  is  caused  at  the  end  of  the  next  shift. 

Trie  case  queue  is  examined  in  NUCRU  for  single  resource  cases, 
multi -resource  needs  and  long  search  needs  that  can  be  served  by  idle 
resources . 

3.  Exogenous  Event  OPSIM  creates  a temporary  entity,  CASE,  for 
the  incoming  case.  Attributes  of  the  case  are  read  from  the  exogenous 
event  tape.  The  primary  station  of  the  case,  which  is  stored  in 
STATN  (CASE),  is  among  the  input  data  received  from  the  preprocessor. 

Note  that  there  is  not  necessarily  a one-to-one  correspondence  between 
the  preprocessor  and  operational  simulator  station  numbers;  therefore, 
STATN (CASE)  is  converted  to  the  correct  OPSIM  station  number.  After 
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this  initial  conversion,  STAIN  (CASE)  may  be  changed  again  in  an  effort  to 

detennine  die  best  primary  station  of  the  case.  If  STATN (CASE)  was  converted 
to  a zero  value  (meaning  that  the  preprocessor  station  did  not  exist  as  such 
in  the  operational  simulator) , STATN (CASE)  is  set  equal  to  the  nearest  OPSIM 
station  in  the  district  that  is  capable  of  being  a primary  station.  If  STATN 
(CASE)  was  converted  to  an  existing  operational  simulator  station  that  is 
capable  of  being  a primary,  STAIN (CASE)  is  set  equal  to  the  nearest  station 
capable  of  being  a primary  in  a set  which  includes  the  primary  and 
all  of  its  adjacents.  If  STATN  (CASE)  was  converted  to  an  existing 
operational  simulator  station  that  is  not  capable  of  being  a primary, 

STATN (CASE)  is  set  equal  to  the  nearest  OPSIM  station  in  the  district 
that  can  be  a primary. 

Impossible  combinations  of  case  attributes  are  checked  for, 
and  if  any  are  found,  the  case  is  filed  into  the  exceptional  cases 
set,  EXCS.  Exogenous  Event  OPSIM  calls  Subroutine  SRCH  for  cases 
with  long  searches,  calls  Subroutine  SRAS  for  single  resource  cases 
and  calls  Subroutine  MRAS  for  ml ti -resource  cases. 

4.  Subroutine  SPAS  serves  as  a driver  for  single  resource  cases. 

That  is,  it  calls  all  necessary  subroutines  to  find  an  ordered  set 
of  resources,  to  select  one  of  those  resources  and  to  serve  the  case. 

5.  Subroutine  GRES  determines  all  resources  capable  of  serving 
a single  resource  case,  a multi -resource  need  or  a long  search  need. 

To  obtain  the  resource  types  capable  of  serving  a case,  Subroutine 
GRES  first  determines  six  applicable  rows  of  the  Resource  Capability 
Matrix  from  the  values  SWELL  (CASE),  WIND  (CASE) , VIS  (CASE),  AIR(CASE) , 
OFSHR(CASE) , and  NEED (CASE) . These  six  rows  (The  rows  of  the 
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Resource  Capability  Matrix  are  input  as  octal  numbers  in  the 
Initialization  Deck,  See  Section  II,  Part  W.)  are  "ANTPed  using 
the  FORTRAN  MB  function  to  yield  a final  answer  giving  all  the 
capable  resource  types  which  are  stored  in  IRAY1,  Next,  Subroutine 
CRES  determines  all  stations  that  can  serve  a case  and  stores  them 
In  IRAY2,  All  resources  that  meet  the  resource  type  and  station 
requirements  are  then  filed  into  RQUE , Note  that  if  the  number  of 
resource  types  is  ever  Input  greater  than  twenty,  Subroutine  CRES 
must  be  recompiled  and  reassembled  to  increase  the  dimension  of  IRAY1. 

In  like  manner,  if  it  is  ever  anticipated  that  the  number  of  stations 
capable  of  serving  a case  may  exceed  thirty,  the  dimension  of  IRAY2 
must  be  increased. 

6.  Subroutine  YEC  calculates  TVEC  (time- to -vector  to  the  incoming 
case)  for  each  resource  in  RQUE.  Note  that  time -to -vector  (TVEC)  is  a 
function  of  the  location  of  the  resource  and  speed  of  the  resource's 
type , which  in  turn  is  a function  of  swell  (SWELL) . 

7.  Subroutine  OSET  orders  the  capable  resources  in  RQUE.  DVEC  is 
set  equal  to  TVEC  (time -to -vector)  for  each  capable  resource.  However,  if 
the  resource  is  idle  at  it's  home  station,  DVEC  is  redefined  to  be 

TVEC  + DLAY  (a  delay  time  necessary  to  ready  the  resource) . Those  re- 
sources with  a DVEC  less  than  or  equal  to  the  tolerance  of  the  priority 
of  the  case  are  filed  into  the  set,  CSET,  which  is  ranked  on  the  attribute 
C0ST  with  low  value  considered  best.  Before  the  resource  is 
filed  into  CSET,  the  attribute  COST  is  set  according  to  the 
cost  option  (COSTO) . If  the  COSTO  is  equal  to  zero,  COST  of 
the  resource  is  set  equal  to  the  relative  cost  ranking  of  the  type 
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of  the  resource.  If  COSTO  is  equal  to  one,  COST  of  the  resource  is 
set  equal  to  the  cost  per  day  (COSTD)  of  the  type  of  the  resource 
times  the  time-to-vector  (TVEC) . Those  resources  that  cannot  vector 
to  the  case  within  tolerance  are  filed  into  the  set,  TSET, which  is 
ranked  on  the  attribute  DVEC  with  low  value  considered  best.  The 
two  sets  are  then  merged;  all  resources  in  CSET  are  filed  into  RQUE 
and  then  all  resources  in  TSET  are  filed  into  RQUE. 

8.  Subroutine  RESAP  searches  for  a resource  in  RQUE  to  serve  a 
single  resource  case,  a multi -resource  need  or  a long  search  need. 

It  is  divided  into  eight  main  sections:  (1)  searching  for  an  idle 

resource  at  the  primary  station,  (2)  searching  for  an  idle  resource 
in  RQUE,  (3)  searching  for  an  idle  resource  at  an  adjacent  station, 

(4)  searching  for  a resource  that  can  be  interrupted  at  the  primary 
station,  (5)  searching  for  a resource  that  can  be  interrupted  at  an 
adjacent  station,  (6)  searching  for  a resource  that  can  be  inter- 
rupted in  RQUE,  (7)  setting  JRS  = 0 to  indicate  to  the  calling 
subroutine  that  no  resource  is  immediately  available,  and  (8) 
printing  an  error  message  for  any  impossible  route.  The  sequence  for 
exercising  these  sections  is  determined  by  the  user  input  variable, 
RAP  (Resource  Assignment  Policy.)  As  an  example,  if  RAP  = 2, 
sections  1,  4,  3,  5 and  7 are  exercised  in  that  order.  If  at  any 
point  a resource  is  found  in  sections  1,  4,  3 or  5,  Subroutine 
RESAP  returns  the  number  of  that  resource  to  the  calling  subroutine 
and  subsequent  sections  are  not  executed.  Note  that  primary  station 
in  this  explanation  of  RESAP  includes  the  aircraft  covering  stations 
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of  -the  primary  and  the  covering  cutters  of  the  primary.  Moreover, 
"adjacent  station"  includes  the  aircraft  covering  stations  of  the 
adjacent  and  the  covering  cutters  of  the  adjacent. 

9.  Subroutine  ROCA  determines  both  if  the  resource,  selected 
by  Subroutine  RESAP,  is  operational  and  if  there  is  an  available 
crew.  A standby  crew  may  be  called  if  the  number  of  crews  at  the 
station  of  the  resource  has  decreased  to  the  user  input  value  of  CL 
(crew  level  at  which  a standby  crew  is  called)  and  if  the  case  has 
not  previously  caused  a standby  to  occur.  Note  that  if  CL  is  equal 
to  -1,  standby  crews  will  never  be  called. 

10.  Subroutine  MRAS  is  called  for  every  multi -resource  case. 

It  establishes  timing  and  causes  an  Event  Notice  NOTIF  for  non- tow 
needs.  If  the  case  requires  a tow,  Subroutine  TOW  is  called. 

11.  Endogenous  Event  NOTIF  calls  the  routines  (CRES,  VEC,  OSET, 
and  RESAP)  necessary  to  locate  a resource  which  can  serve  a single 
need  of  a multi -resource  case.  If  no  capable  resource  exists, 
Subroutine  WRECK  is  called  to  destroy  the  case.  If  no  capable  resource 
is  available,  the  need  associated  with  the  NOTIF  is  filed  in  the 
queue  CQUE  via  a call  to  Subroutine  QUEUE.  If  a capable  resource  is 
available,  Subroutine  SERVE  is  called. 

12.  Subroutine  TOW  creates  an  Event  Notice  NOTIF  for  each  tow 
need  of  a multi -resource  case.  It  determines  the  distance  and  destin- 
ation of  the  tow  via  a call  to  Subroutine  DTD.  This  information  is 
used  to  establish  hand-off  coordinates.  If  there  are  no  non- tow  needs, 
the  first  tow  NOTIF  is  caused.  (If  there  are  non-^tow  needs,  the  first 
tow  NOTIF  is  caused  in  Endogenous  Event  ONSCN.) 
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13.  Subroutine  DTD  determines  the  final  destination  for  tow 
cases.  ’The  destination  is  the  primary  station  of  the  case  unless 
the  primary  station  is  a patrol.  In  this  case  the  destination  is 
the  (first)  adjacent  station  of  the  primary  station.  The  total 
distance  of  the  tow  is  also  calculated.) 

14.  Subroutine  SRCH  creates  an  Event  Notice  NOTE  for  each 

long  search  need.  If  it  is  night  time  (i.e.,  the  present  time  is  greater 
than  or  equal  to  sunset  and  less  than  the  time  at  which  the  sunrise 
list  is  examined) , Subroutine  SRCH  attempts  to  serve  the  first  search 
need.  All  remaining  search  needs  are  filed  into  LIST  - the  sunrise 
list.  If  it  is  daytime,  Subroutine  SRCH  attempts  to  serve  the  first 
search  need.  All  other  search  needs  are  caused  to  occur  at  TIME 
+ EPSLN,  where  EPSLN,  a user  input,  is  a small  time  delay  usually 
set  to  two  minutes. 

15.  Endogenous  Event  NOTE  occurs  at  TIME  + EPSLN  for  all  but 
the  first  search  need  of  a long  search  case  that  occurs  during  the 
daytime.  An  attempt  is  made  to  serve  the  need.  If  no  resource  is 
available,  the  search  need  is  filed  into  CQUE. 

16.  Subroutine  SASS  orders  the  resources  in  RQUE  for  search 
needs  only.  A call  is  made  to  Subroutine  GRES  to  gather  all  capable 
resources  in  the  set  RQUE.  Subroutine  VEC  is  called  to  calculate 
TVEC  for  each  resource  in  RQUE.  The  local  variable  TOLRS  is  set 

equal  to  the  search  tolerance  of  the  priority  of  the  case.  If,  however, 
the  present  time  plus  the  search  tolerance  of  the  case  priority  is 
greater  than  the  next  sunset,  TOLRS  is  redefined  to  be  sunset  minus 
the  present  time.  (Note  that  this  redefinition  of  TOLRS  is  used  only 
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in  the  calculation  of  PR  for  airplanes  and  not  in  the  PR  calculation 
for  small  boats  and  cutters.)  PR  (percentage  of  search  miles  that  a re- 
source is  capable  of  completing  before  sunset  or  within  the  search 
tolerance  time  of  the  case  priority)  is  then  calculated  for  each  resource 
in  ROUE . Those  resources  that  can  complete  the  desired  percentage  of 
search  miles  are  filed  into  CSET.  Resources  that  cannot  complete  the 
desired  percentage  of  search  miles,  but  have  a PR  value  greater  then 
0.0  are  filed  into  PSET  which  is  ranked  on  the  attribute  PR  with  high 
value  considered  best.  The  remaining  resources  with  a PR  value  of  0.0 
are  filed  into  TSET  if  they  meet  an  endurance  check.  The  three  sets 
are  then  merged  into  RQUE. 

17.  Subroutine  SSS  is  the  service  routine  for  long  search  needs. 

RES  and  FLT  attributes  are  updated.  Any  previously  scheduled  future 
event  for  the  resource  serving  the  long  search  need  is  cancelled  and 
destroyed.  If  the  resource  was  idle  at  its  home  station  when  chosen,  — 
an  Endogenous  Event  READY  is  created  and  caused.  If,  however,  the 
resource  was  not  at  its’  home  station,  an  Endogenous  Event  ARSQI  is 
created  and  caused  for  the  resource  serving  the  long  search  need. 

18.  Endogenous  Event  READY  occurs  at  the  end  of  the  delay  time 
necessary  to  ready  a resource  at  it’s  home  station  before  serving  a 
long  search  need.  TVEC  (time -to -vector)  is  calculated,  DEP  (departure 
time)  is  set,  XIEST  (X  coordinate  of  destination)  is  set,  and  YDEST 

(Y  coordinate  of  destination)  is  set.  An  Endogenous  Event  ARSCH  is 
created  and  caused  to  occur  at  TIME  + TVEC. 
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19.  Endogenous  Event  ARSCH  occurs  when  a resource  arrives  on 
scene  to  serve  a long  search  need.  Depending  on  the  endurance  of  the 
resource  and  the  present  time,  one  of  three  possible  future  events  - 
FUEL,  SSET  or  COMPL  - is  created  and  caused  to  occur. 

20.  Endogenous  Event  COMPL  occurs  when  a long  search  need  is 
completed.  A check  is  made  to  determine  if  all  long  search  needs  of 
the  case  are  completed.  If  this  is  true,  Subroutine  SRAS  is  called 
for  single  resource  cases,  Subroutine  MRAS  is  called  for  multi -resource 
cases,  and  Subroutine  TERM  is  called  for  cases  that  have  no  additional 
needs . 

21.  Endogenous  Event  SSET  occurs  at  sunset  when  a resource 
serving  a long  search  need  is  taken  off  the  case  because  of  darkness. 

The  search  need  is  placed  in  the  sunrise  list  and  a call  is  made  to 
EXQ  for  the  now  idle  resource. 

22.  Endogenous  Event  FUEL  occurs  when  a resource  serving  a long 
search  need  must  return  home  to  refuel.  Attributes  are  updated  and 
Endogenous  Event  HOMEF  is  created  and  caused  to  occur. 

23.  Endogenous  Event  HOMEF  occurs  when  a resource  arrives  at  it’s 
home  station  to  refuel.  Attributes  are  updated  and  Endogenous  Event 
SNDBK  is  created  and  caused  to  occur. 

24.  Endogenous  Event  SNDBK  occurs  at  the  completion  of  refueling 
of  a resource  serving  a long  search  need.  At  this  point,  the  temporary 
entity  FLT  is  destroyed  for  the  refueled  resource,  and  it  is  returned 
to  an  idle  status . A call  is  made  to  Subroutine  SASS  to  gather  an 
ordered  set  of  resources  capable  of  serving  the  remaining  portion  of  the 
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long  search  need.  The  set  RQUE  is  then  examined  for  the  best  idle 
resource  to  serve  the  need.  Xf  the  best  idle  resource  is  the  re- 
fueled resource  that  last  served  the  search  need,  a new  FLT  is  created, 

RES,  FLT  and  NOTE  attributes  are  updated,  and  an  arrive -on -scene  event 
(ARSCH)  is  created  and  caused  to  occur  at  TIME  + TVEC.  However,  if  the 
best  idle  resource  is  any  other  resource,  Subroutine  SSS  is  called. 

25.  Endogenous  Event  SRISE  occurs  at  RISE-XRX.  The  sunrise  list 
is  examined  and  resources  are  vectored  to  arrive  on  the  search  scene 
at  sunrise  or  soon  thereafter.  The  next  SRISE  is  caused  at  TIME  + 

1 . 0 (day) . 

26.  Endogenous  Event  XSET  occurs  at  sunset  each  day.  All  queued 

long  search  needs  are  removed  from  CQUE  and  filed  into  the  sunrise  list, 

LIST.  The  next  XSET  is  caused  at  TIME  +1.0  (day). 

27.  Subroutine  SERVE  is  called  every  time  a resource  is  assigned 

to  a case  for  reasons  other  than  a long  search.  Data  is  accumulated 
for  several  statistics  (COSTC,  CNRES,  NEEDS  and  NCASE) . If  the  re- 
source is  at  it's  home  station,  a temporary  entity  FLT  is  created  to 
be  associated  with  the  resource  until  it  returns  home  via  Endogenous 
Event  HOME.  RES  and  FLT  attributes  are  updated  and  an  Event  Notice 
DELAY  is  created  and  caused.  If  the  resource  is  not  at  its  home  'S 

station,  any  event  previously  scheduled  for  the  resource  in  connection 
with  some  other  case  is  cancelled  and  destroyed.  RES  and  FLT  attributes 
are  updated  and  an  Endogenous  Event  ARVSN  is  created  and  caused. 

28.  Endogenous  Event  DELAY  occurs  at  the  end  of  the  delay  time 
necessary  to  ready  a resource  at  it's  home  station  before  vectoring  to 
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the  scene  of  any  need  other  than  a long  search  need.  XDEST  and  YEEST 

(destination  coordinates)  are  set;  DEP  (departure  time)  and  TpLT  (time  that 

/ 

resource  leaves  its  home  station)  are  set  equal  to  TIME.  An  Endogenous 
Event  ARVSN  is  then  created  and  caused  to  occur  at  TIME  + ROS. 

29.  Endogenous  Event  ARVSN  occurs  when  a resource  arrives  at  the 
scene  of  a case  for  reasons  other  than  a long  search.  If  the  resource 
is  the  first  resource  to  arrive  on  scene,  data  is  collected  for  the 
statistics  RESA,  WAIT,  NCAS,  AVGW,  TQUE1,  and  JFAIL3.  Subroutine  STATS 
is  also  called  to  collect  other  case,  station  and  group  statistics. 

If  this  is  the  first  resource  to  arrive  on  scene  there  is  a check  to 
see  if  a short  search  is  needed.  If  so,  there  is  a call  to  Subroutine 
SRCHF  which  establishes  the  information  needed  for  a short  search. 

The  priority  of  the  case  is  increased  to  S2PRI  until  the  short  search 
is  completed.  ARVSN  also  determines  the  resource  responsible  for 
maintaining  coverage.  The  resource  responsible  for  coverage  is  chosen 
from  among  all  resources  at  the  scene  of  the  case  as  that  resource 
associated  with  the  greatest  value  of  RLS.  RLS  is  equal  to  the  time 
that  the  resource  arrived  on  scene  plus  the  on  scene  time  during  which 
the  resource  will  actually  serve  the  particular  need.  If  a covering 
resource  has  fulfilled  its  on  scene  time,  the  next  resource  to  arrive 
on  scene  will  become  responsible  for  coverage  and  the  resource  formerly 
covering  will  be  relieved  of  duty  via  a call  to  Subroutine  RETN. 
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Still  another  function  of  ARVSN  is  to  determine  the  on  scene 
time  if  the  resource  will  be  towing  or  providing  an  air  escort. 

For  single  resource  cases  there  is  a call  to  Subroutine  DTD  to  deter- 
mine the  destination  and  distance  for  the  tow.  (For  multi -resource 
cases  this  information  was  previously  determined  and  stored  by 
a call  to  Subroutine  TOW  from  MRAS.)  The  length  of  the  case  as 
well  as  the  type  of  resource  serving  the  tow  or  air  escort  determine 
the  speed  at  which  the  tow  proceeds  and  thus  the  on  scene  time. 

30.  Subroutine  STATS,  which  can  be  called  from  Endogenous  Event 
ARVSN  or  from  Endogenous  Event  ARSCH,  collects  station,  group  and 
district  statistics  when  the  first  resource  arrives  at  the  scene 

of  a case.  It  also  accumulates  case  statistics  for  both  week- 
days and  weekends  with  holidays  being  included  in  the  weekend 
statistics. 

31.  Subroutine  SRCHF  is  called  when  the  first  ARVSN  occurs 
for  a case  requiring  a short  search.  If  an  additional  resource 

is  needed,  Subroutine  SASS  and  RESAP  are  called.  If  an  additional  re- 
source is  located,  the  associated  on  scene  time  is  calculated.  The  on 
scene  time  of  the  resource  having  the  first  ARVSN  is  increased  so  that 
it  remains  on  scene  until  the  short  search  is  completed.  For  multi - 
resources  cases  an  Event  Notice  NOTIF  is  created  to  be  associated  with 
the  short  search.  The  additional  resource  is  assigned  to  the  case  via 
a call  to  Subroutine  SERVE.  If  the  short  search  was  originally  to 
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be  handled  by  the  first  arriving  resource  or  if  there  is  no  additional 
resource  available,  the  resource  having  the  first  ARVSN  will  also 
serve  the  short  search.  The  on  scene  time  for  this  resource  is  in- 
creased to  include  the  time  spent  searching. 

32 . Endogenous  Event  ONSCN  occurs  differently  for  resources  that 
are  towing  and  resources  serving  non- tow  needs.  For  non- towing 
resources  there  is  an  ONSCN  when  the  resource  first  arrives  on 
scene  and  thereafter  at  intervals  of  time  equal  to  the  on  scene  time 
divided  by  KKK,  On  all  but  the  last  ONSCN  for  a particular  resource 
there  is  a reevaluation  of  the  case  priority.  At  the  last  ONSCN  for 
the  resource  serving  the  last  non-tow  need  of  a case  there  is  a check 
to  see  if  a tow  is  needed.  If  so  the  first  tow  is  initiated.  A call 
to  Subroutine  CRES  determines  whether  or  not  the  resource  serving 
the  last  non-tow  need  can  also  serve  the  tow.  If  so,  it  is  assigned 
to  serve  the  tow  via  a call  to  Subroutine  SERVE.  If  not,  an  Event  Notice 
NOTIF  is  caused  for  the  first  tow.  If  a resource  is  not  responsible 
for  coverage  at  the  time  of  its  last  ONSCN,  it  is  relieved  of  duty  via 
a call  to  Subroutine  RETN.  For  towing  resources  there  is  only  one 
occurrence  of  ONSCN,  that  being  when  the  tow  is  completed.  There  is 
no  reevaluation  of  the  case  priority  in  this  situation.  If  the  resource 
is  completing  the  first  of  a two  part  tow,  an  Event  Notice  NOTIF  is 
created  for  the  second  tow.  The  attribute  COUNT (CASE)  keeps  track 
of  the  number  of  needs  and  tows  for  the  case  which  have  been  completed. 
This  variable  is  increased  by  one  whenever  a resource  has  its  last  ONSCN 
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for  a particular  case.  There  is  one  exception  to  the  above  description 
which  applies  to  short  searches  which  are  served  by  the  first  resource 
to  arrive  on  the  scene  of  the  case.  The  first  occurrence  of  ONSCN  for 
such  a resource  is  after  the  short  search  is  completed.  The  priority  of 
the  case  is  immediately  restored  to  the  original  case  priority  and  the 
on  scene  time  applicable  for  this  resource  is  reduced  to  its  origianl 
value.  (Subroutine  SRCHF  increases  on  scene  time).  Thereafter  the 
above  description  applies  depending  on  whether  the  resource  is  towing  or 
not. 

33.  Subroutine  COVER  is  called  when  a resource  responsible  for 
coverage  is  interrupted  to  serve  another  case.  It  considers  all 
other  resources  on  the  scene  of  the  case  being  interrupted  to  determine 
another  resource  responsible  for  coverage.  As  explained  in  the  des- 
cription of  ARVSN,  the  attribute  RLS  is  used  to  establish  coverage. 

34.  Endogenous  Event  CHEKN  occurs  every  TCHEK  hours  for  a covering 
resource.  Subroutine  EXQ  is  called  to  determine  if  the  covering  resource 
can  serve  any  case  in  the  queue.  If  it  cannot  serve  any  case  in  the 
queue,  it  remains  as  the  covering  resource  on  it’s  present  case  and 
another  CHERN  is  created  and  caused  to  occur  at  TIME  + TCHEK.  If  it 

can  serve  a queued  case  or  need,  Subroutine  EXQ  updates  all  applicable 
attributes  and  calls  the  proper  subroutine  to  serve  the  case  or  need. 

35.  Subroutine  RETN  is  called  when  a resource  serving  other  than 
a long  search  finishes  an  assignment.  It  relieves  the  resource  of  its 
current  duty  by  setting  IB  = 0 and  returns  the  resource  to  the  system 
via  a call  to  Subroutine  EXQ.  If  the  resource  was  an  additional 
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resource  serving  only  a short  search,  the  priority  of  the  case  is  reduced 
to  its  original  level.  If  COUNT  (CASE)  indicates  that  all  needs  and  tows 
of  the  case  have  been  completed,  the  case  is  terminated  via  a call  to 
Subroutine  TERM. 

36.  Subroutine  TERM  occurs  when  all  the  needs  and  tows  of  a case 
have  been  completed.  TSVC  (time  case  spent  in  system)  statistics  are 
accumulated  and  the  value  of  STATE  is  tested.  If  STAPE  is  not  equal 

to  zero,  all  pertinent  case  attributes  are  output  on  logical  unit  STAPE 
for  the  post  processor.  There  is  no  output  for  the  post  processor  if 
STAPE  is  equal  to  zero.  All  temporary  entities  and  event  notices  associated 
with  the  case  as  'well  as  the  case  itself  are  destroyed. 

37.  Endogenous  Event  HOME  occurs  when  a resource  arrives  at  its 
home  station  after  finishing  an  assignment.  The  temporary  entity  FLT 
is  destroyed  and  expected  idle  alpha  time  (EIAT)  is  set  to  zero. 

The  coordinates  of  the  resource  are  set  to  the  coordinates  of  the  home 
station  and  the  number  of  busy  crews  is  reduced  by  one.  Utilization 
data  is  collected  in  TUTIL. 

38.  Subroutine  SAQ  is  called  from  RESAP  when  a single  resource 
case,  a multi -resource  need  or  a long  search  need  is  interrupted.  If 
a tow  was  interrupted,  the  location  of  the  case  and  the  location  of 
the  resource  are  updated  to  be  the  previously  calculated  interrupt  lo- 
cation of  the  resource.  Interrupt  statistics  (NOINT,  TOTIN  and  NINTR) 
are  accumulated.  Subroutine  COVER  is  called  if  the  resource  was 
covering  on  the  interrupted  case.  If  it's  determined  that  the  interrupted 
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resource  was  covering  only,  no  attempt  is  made  to  vector  an 
idle  resource  to  the  scene  for  coverage  purposes. 

If  a single  resource  case  or  a search  need  has  been  interrupted, 
Subroutine  SAQ  attempts  to  find  an  idle  resource  to  serve  it.  The 
case  or  need  is  queued  if  no  capable  resource  is  available.  If  a 
multi -resource  need  has  been  interrupted,  Subroutine  QUEUE  is  called. 

39.  Subroutine  QUEUE  is  called  when  a resource  is  interrupted 

while  serving  a multi -resource  need  or  when  no  capable  resource  is  available 
to  serve  a multi -resource  need.  In  the  interrupt  situation,  an  attempt 
is  made  to  locate  another  resource  to  serve  the  need  via  calls  to  Sub- 
routines GEES,  VEC,  OSET,  and  ROCA.  The  usual  call  to  RESAP  is  replaced 
by  a search  through  the  ordered  set  of  resources  RQUE.  The  first  non- 
busy resource  with  an  available  crew  is  assigned  to  serve  the  multi- 
resource need  via  a call  to  Subroutine  SERVE.  RESAP  cannot  be  called  since 
it  created  the  interrupt  situation  and  an  infinite  logical  loop  would  be 
generated.  If  no  capable  resource  is  available  to  serve  the  need,  the  NOTIF 
associated  with  the  need  is  filed  in  the  queue  CQUE.  If  there  are  no  other 
NOTIF’ s of  the  case  already  in  CQUE  or  if  there  are  no  other  NOTIF 's  of  the 
case  in  CQUE  due  to  interrupts,  and  this  NOTIF  is  queued  because  of  an 
Interrupt,  the  attributes  TINQ  and/or  STINQ  are  set  to  the  current  value 
of  TIME.  If  an  air  escort  is  to  be  queued,  Subroutine  WRECK  is  called. 

t 

40.  Subroutine  EXQ  examines  the  queue,  CQUE,  for  a single  resource 
case,  a multi -resource  need  or  a long  search  need  that  can  be  served 
by  a resource  becoming  idle.  If  the  resource  is  not  capable  of  serving 
any  case  or  need  in  the  queue,  an  Endogenous  Event  HOME  is  created  and 
caused  for  the  recource. 
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41.  Endogenous  Event  S'lNBY  occurs  when  a standby  crew  arrives 
at  it's  station.  The  queue  is  examined  for  cases  which  that  station 

is  capable  of  serving,,  If  the  crew  cannot  be  used  to  serve  any  CASE  or 
need  in  the  queue,  the  stand-by  crew  is  not  added  to  the  available 
crews  at  the  station.  If  the  crew  can  be  used,  the  appropriate  sub- 
routine is  called  to  serve  the  case. 

42 . Subroutine  SVQUE  is  called  when  a resource  is  assigned  to 
serve  a NOTIF  in  the  queue  OQUE.  If  there  are  no  other  NOTIPs  of 
the  case  in  CQUE,  the  time  in  queue  TQUE  is  accumulated.  If  this 
NOTIF  was  queued  because  of  an  interrupt  and  if  there  are  no  other 
NOTIF *s  of  the  case  in  the  queue  due  to  interrupts,  the  attribute 
TINT  is  accumulated.  The  NOTIF  is  removed  from  CQUE  and  Subroutine 
SERVE  is  called. 

43.  Subroutine  WRECK  is  called  when  a multi-resource  case  is 
being  terminated  for  reasons  other  than  completion.  It  cancels  and 
destroys  temporary  entities  and  event  notices  associated  with  the 
case.  Any  resources  serving  the  case  are  released  via  a call  to  Sub- 
routine EXQ.  The  case  is  filed  in  a set  of  exceptional  cases  EXCS 

to  be  output  at  the  end  of  the  simulation. 

44.  Exogenous  Event  ENDSIM  occurs  when  the  simulation  is  to  end. 

It  is  triggered  by  the  last  entry  on  the  Exogenous  Event  Tape  con- 
taining the  case  input  data.  Output  data  are  averaged  over  time  and 
DRIVE  is  called  to  control  the  report  output.  The  statistics  and 
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data  of  the  report  output  will  be  described  later  in  part  VI  of  this 
section.  All  cases  in  the  set  of  exceptional  cases  EXCS  are  output 
on  logical  unit  STAPE,  if  STAPE  is  unequal  to  zero. 

45.  Subroutine  DRIVE  is  called  from  ENDSIM  at  the  end  of  the 
simulation.  It  serves  as  a driver  to  call  the  several  report 
generators  and  the  output  subroutines,  EXCASE  and  JUMPER.  It  also 
generates  printed  output  for  cases  remaining  in  CQUE  and  for  cases 
still  being  served  at  the  end  of  the  simulation. 

46.  Report  SARSIM  is  the  report  generator  for  printing  district 
statistics  and  station  response. 

47.  Report  GRPRES  prints  group  response. 

48.  Report  HEADER  is  the  report  generator  for  printing  the 
heading  of  the  resource  utilization  section. 

49.  Report  TITLE  is  the  report  generator  for  printing  resource 
utilization  for  each  shift  at  each  station. 

50.  Report  RESULT,  a report  generator,  prints  the  utilization 
of  each  resource. 

51.  Report  HEAD,  a report  generator,  prints  the  heading  of  the 
exceptional  cases  section. 

52.  Subroutine  EXCASE  prints  all  exceptional  cases  in  the 
set  EXCS. 

53.  Report  DSTRIB  prints  daily  utilization  distributions 
and  certain  case  attribute  distributions. 

54.  Subroutine  JUMPER  is  an  output  routine  printing  all 
changes,  additions  and  deletions  to  the  initialization  data  base.  It 
is  coded  in  FORTRAN. 
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B.  Note  on  Flowchart  Nomenclature 


It  should  be  mentioned  that  attribute  names  shown  in  the 
flowcharts ^are  sometimes  abbreviated  relative  to  the  names  in  the 
computer  programing  code.  This  abbreviation  is  due  to  the  length- 
iness of  the  subscripts  required  to  completely  identify  a particular 
entity  or  event  notice  of  which  the  variable  is  an  attribute.  The  context 
removes  any  possible  ambiguity.  For  example,  CUT (ADIS (STAN (CASE) , I) f J) , 
which  is  the  Jth  cutter  of  the  Ith  adjacent  station  of  the  primary 
station  of  CASE , may  be  abbreviated  at  CUT (ADJS) . 


r 

* All  flowcharts  for  OPSIM  are  found  in  Appendix  A (NBS 
Report  No „ 10435) . 
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IV . OPSIM  Input  Data  Deck 


A.  Composition  of  the  data  deck 

The  data  deck  is  composed  of  the  system  specifications  card, 
the  initial  conditions  deck,  a blank  card,  the  exogenous  events  deck 
and  input  data  for  Subroutine  JUMPER.  The  order  of  these  is  illustrated 
in  figure  IV  - 1 below. 


Figure  IV  - 1 

B.  System  Specifications  Card 

The  contents  and  format  of  the  system  specifications  card 

follow ; 


Columns 

1 

6 


7-12 


Contents 

The  number  one  (1) . 

If  this  Column  is  non -blank,  the 
initial  conditions  deck  will  output 
to  the  printer. 

Maximum  array  number  that  appears  in 
columns  32  through  34  of  the  Definition 
Form  (Section  II,  Part  II).  This  inte- 
ger is  right- justified  in  the  field  and 
presently  has  the  value  of  175. 
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13-18  Right -justified  integer  number  of 

minutes  per  hour  of  simulated  time.  If 
left  blank,  the  number  of  minutes  per 
hour  is  assumed  to  be  60.  For  OPSIM 
runs,  it  may  be  left  blank. 

19-24  Right- justified  integer  number  of 

hours  per  day  of  simulated  time. 

If  left  blank,  the  number  of  hours 
per  day  is  assumed  to  be  24.  For 
OPSIM  runs,  it  may  be  left  blank. 

25-30  The  initial  value  of  the  root  to  be 

used  in  generating  random  numbers. 

This  is  a right- justified  integer  and 
must  be  an  odd  number.  If  left 
blank,  it  is  assumed  to  be  1.  It 
is  suggested  that  the  user  fill 
the  field  with  an  odd  number. 

31-36  Right-justified  integer  indicating 

the  logical  tape  unit  from  which 
the  initial  conditions  deck  is 
read.  If  left  blank,  the  initial 
conditions  deck  will  be  read  from 
logical  tape  unit  five  - the 
card  reader, 

37-42  Right-justified  integer  indicating 

the  logical  tape  unit  from  which  the 
exogenous  events  deck  is  read.  If 
left  blank,  logical  tape  unit  five  - 
the  card  reader—is  assumed. 

43-48  Right-justifi 2d  integer  indicating 

the  logical  tape  unit  on  which  re- 
ports are  written.  If  left  blank  , 
logical  tape  unit  six  - the  printer  - 
is  assumed. 
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49-54 


Number  of  lines  per  page  of  printed 
output.  This  is  a right- justified 
integer,  the  maximum  value  of 
which  is  59 . The  number  of  lines 
will  be  55  if  this  field  is  left 
blank. 

C.  Initial  Conditions  Deck 

1.  Composition  of  Initial  conditions  deck 

The  Initial  conditions  deck  consists  of  initialization  cards  and 
data  cards  keypunched  from  the  form  shown  In  Figure  IV- 2.  Every 
array  number  appearing  in  columns  32-34  of  the  definition  deck  must 
be  accounted  for  in  sequential  order  in  the  initialization  cards. 

It  is  suggested  that  the  user  read  Chapter  14  (Initial  Conditions 
Deck)  in  SIMSCRIPT , A Simulation  Programming  Language  by  Markowitz, 
Hausner  and  Karr  for  farther  explanations  on  procedures  for  pre- 
paring tiie  initial  conditions  deck. 

2.  Explanation  of  format  and.  content  of  OPSIM's  initial  conditions 
deck  using  the  Thirteenth  Coast  Guard  District,  July  1968,  as  an  example. 
Note  that  all  data  is  right --justified  unless  otherwise  specified. 
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SIMSCRIPT  Initialization  Form  (actual  size)  Figure  IV-2  .39. 
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EXPLANATION  OF  INITIAL  CONDITIONS  INPUT 


INITIALIZATION  CAFD 

COLUMNS 

CONTENT 

1 

1-4 

The  number  "1". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the  total 

number  of  resources  in  a run. 

67-80 

Field  for  comment. 

2 

1-4 

The  number  "2". 

5-8 

The  number  "5". 

10 

The  number  "1". 

13 

The  letter  "Z". 

15-18 

Integer  giving  the  total  number  of  resources. 

19-22 

The  number  "1". 

34 

The  number  "2". 

67-80 

Field  for  comment. 

3 

1-4 

The  number  "6". 

5-8 

The  number  "7". 

o 

rH 

The  number  "1". 

13 

The  letter  "Z". 

15-18 

i 

Integer  giving  the  total  number  of  resources. 

19-22 

The  number  "1". 

34 

The  number  "4". 

i 67-80  | 

Field  for  comment. 

4 

1-4 

The  number  "8". 

5-8 

The  number  "20". 

i—1 

o 

The  number  "1". 

; 13 

The  letter  "Z". 

1 15-18 

Integer  giving  the  total  number  of  resources . 

19-22 

The  number  ”1". 

34 

The  number  "2". 

67-80 

Field  for  comment. 

5 

1-4 

The  number  "21". 

5-8 

The  number  "22". 
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INITIALIZATION  CARD 

COLUMNS 

CONTENT 

10 

The  number  "1". 

13 

The  letter  "Z". 

15-18 

Integer  giving  the  total  number  of  resources 

19-22 

The  number  "1". 

34 

The  number  "4". 

67-80 

Field  for  comment. 

6 

1-4 

The  number  "23". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the  number 
of  resource  types. 

67-80 

Field  for  comment. 

7 

1-4 

The  number  "24" 

10 

The  number  "1", 

13 

The  letter  "Z". 

15-18 

Integer  giving  the  number  of  resource  types. 

19-22 

The  number  "23". 

34 

The  number  "2". 

67-80 

Field  for  comment. 

8 

1-4 

The  number  "25". 

10 

The  number  "1". 

12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  resource  types. 

19-22 

The  number  "23". 

34 

The  number  "2". 

50-66 

Left- justified  format  - 12(H4.1) 

67-80 

i 

Field  for  comment 

i 

Data  cards  must  follow  initialization  card  number  8 to  read  in  en- 
durance times  for  each  resource  type.  The  format  for  these  data  cards 
is  given  in  columns  50-66  of  the  initialization  card.  In  this  case,  the 
format  is  12(H4.1).  The  "12"  gives  the  number  of  fields  per  card. 

The  letter  ”H"  indicates  that  the  endurance  times  are  to  be  read  in 
decimal  hours.  The  "4.1"  indicates  there  will  be  four  places  to  the 
left  of  the  decimal  point,  the  decimal  point  and  one  place  after  the 
decimal  point  making  each  field  occupy  six  columns. 


-48- 


INITIALIZATION  CARD 

COLUMNS 

CONTENT 

9 

1-4 

The  number  "26". 

10 

The  number  "1". 

12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  resource  types 

19-22 

The  number  "23". 

34 

The  number  "2". 

50-66 

Left- justified  format  - 7 (U7 . 2) 

67-80 

Field  for  comment. 

Data  cards  are  required  after  initialization  card  9 to  read  in  the 
cost  per  day  of  each  resource  type.  The  format  7(U7.2),  indicates  seven 
floating  point  numbers  per  card  each  with  seven  places  before  the 
decimal  point,  the  decimal  point  and  two  places  after  the  decimal 
point.  The  "U"  means  that  "unsigned”  floating  point  numbers  are 
being  read  in. 


10 


1-4 

10 

12 

15-18 

19-22 

34 

50-66 

67-80 


The  number  "27". 

The  number  "1". 

The  letter  "R". 

Integer  giving  the  number  of  resource  types . 
The  number  "23". 

The  number  "4". 

Left- justified  format  - 16(14) 

Comment  field. 


Data  cards  to  read  the  relative  cost  ranking  of  each  resource  type 
should  follow  initialization  card  10.  The  format  16(14)  implies  sixteen 
integers  per  card  with  four  columns  per  field. 


11 


1-4 

10 

12 

15-18 

19-22 

34 


The  number  "28". 

The  number  "1". 

The  letter  "R". 

Integer  giving  the  number  of  resource  types . 
The  number  "23n. 

The  number  "2". 
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INITIALIZATION  CARD 

’ 

COLUMNS 

CONTENT 

50-66 

Left-justified 

format  - 12(U4.1). 

67-80 

Comment  field. 

Dat<a  cards  to  read  speed-of- advance  I for  each  resource  type 
follow  card  11.  These  are  read  in  miles  per  day  under  the  format 
12(U4»1) . 


12 


1-4 

10 

12 

15-18 

19-22 

34 

50-66 

67-80 


The  number  "29n. 

The  number  "1". 

The  letter  "R". 

Integer  giving  the  number  of  resource  types. 
The  number  ”23". 

The  number  "2". 

Left- justified  format  - 12(U4.1). 

Comment  field. 


Following  initialization  card  12  are  the  data  cards  to  read  speed- 
of  -advance  II  for  each  resource  type.  These  are  read  in  miles 
per  day  under  the  format  120J4.1). 


13 


1-4 


The  number  "30". 


10 

12 

15-18 

19-22 

34 

50-66 

67-80 


The  number  "1". 

The  letter  "R". 

; Integer  giving  the  number  of  resource  types. 
: The  number  "23". 

| The  number  "2". 

; Left-justified  format  - 12(U4.1). 
j Comment  field. 


Data  cards  to  read  the  search  speed -of -advance  for  each  resource  type 
follow  card  13 . These  are  also  input  in  miles  per  day  under  the 
format  12 (U4 .1) . 


14 


1-4 


The  number  "31". 


10 

12 

15-18 


The  number  "1". 

The  letter  "R". 

Integer  giving  the  number  of  resource  types. 
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INITIALIZATION  CARD 

COLUMNS 

CONTENT 

19-22 

The  number  "23". 

34 

The  number  "4". 

50-66 

Left-justified  format  - 16(14) . 

67-80 

Comment  field 

Data  cards  follow  to  read  in  the  swell  limit  on  speed-of -advance 
I for  each  resource  type.  The  swell  limit  is  expressed  in  feet  under 
the  format  16(14).  Note  that  there  is  no  swell  limit  for  an  air- 
craft resource  type. 


15 


1-4 


The  number  "32”. 


10 

12 

15-18 

19-22 

34 

50-66 

67-80 


The  number  "1". 

The  letter  MR". 

Integer  giving  the  number  of  resource  types 
The  number  "23". 

The  number  "2". 

Left-justified  format  - 12(H4.1). 

Comment  field. 


Data  cards  follow  to  read  the  time -to -re fuel  for  each  resource 
type.  The  format  is  12(H4.1). 


16 


1-4 

10 

12 

15-18 

19-22 

34 

50-66 

67-80 


The  number  "33". 

The  number  "1". 

The  letter  "R". 

Integer  giving  the  number  of  resource  types 
The  number  "23". 

The  number  "2". 

Left-justified  format  - 13(U2.2). 

Comment  field. 


Data  cards  follow  to  input  operational  probabilities  for  each 
resource  type  under  the  format  13 (U2 . 2) . 


17 


1-4 


The  number  "34". 


18 


12 

50-66 

67-80 

1-4 

10 


The  letter  "R". 

Left-justified  integer  giving  the  number 
of  stations. 

Comment  field 

The  number  "35". 

The  number  "2". 
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INITIALIZATION  CARD 


COLUMNS 


CONTENT 


12 

The  letter  "R". 

15 

- 18 

Integer  giving  the  number  of  stations 

19 

- 22 

The  number  "34". 

40 

The  number  "4". 

41 

The  letter  "R". 

50 

- 66 

Left-justified  format  - 14(15). 

67 

- 80 

Comment  field 

Following  initialization  card  18  is  the  ragged  table  (refer  to  Mar 
Markowitz  for  an  explanation  of  ragged  tables)  to  input  the  covering 
aircraft  stations  of  each  station.  There  is  usually  one  input  card 
per  station  in  this  set  of  data  cards.  Each  card  contains  the  air- 
craft covering  stations  of  one  station  under  the  format  14(15)  and  an 
integer  right-justified  in  columns  71  and  72  giving  the  number  of 
fields  to  be  read  from  the  card.  If  a station  has  more  than  14  air- 
craft covering  stations,  the  first  card  would  contain  the  first  14 
and  the  letter  "C"  heypunched  in  column  72.  The  next  card  would  con- 
tain the  remaining  aircraft  covering  stations  with  the  numbers  of 
fields  to  be  read  keypunched  in  columns  71  and  72.  Note  that  if  a 
station  has  no  aircraft  covering  station,  a "0"  should  be  keypunched 
in  column  4 and  a "1"  should  be  keypunched  in  column  72  on  the  card 
for  that  station. 


19 


1-4 

10 

12 

15-18 
19-22 
| 40 

i 41 

50-66 

67-80 


The  number  "36". 
j The  number  "2". 

■ The  letter  "R". 

| Integer  giving  the  number  of  stations. 
The  number  "34". 

The  number  "4". 

The  letter  "R". 

Left-justified  format  - 14(15). 

Comment  field 


Following  initialization  card  19  is  the  ragged  table  to  input 
the  adjacent  stations  of  each  station.  The  above  discussion 
on  the  ragged  table  input  of  aircraft  covering  stations  applies 
here  also. 


20 


10 

12 

15-18 

19-22 

40 

41 


The  number  "37". 

The  number  "2". 

The  letter  "R". 

Integer  giving  the  number  of  stations. 
The  number  "34". 

The  number  "4". 

The  letter  "R". 
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INITIALIZATION  CARD 

COLUMNS 

CONTENT 

50-66 

Left-justified  format  - 14(15). 

67-80 

Comment  field. 

Following  card  20  is  the  ragged  table  to  input  the  covering 

cutters  of  each  station. 

The  discussion  of  ragged  table  input 

above  applies 

21 

1-4 

The  number  "38". 

10 

The  number  "1". 

12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  stations . 

19-22 

The  number  "34". 

34 

The  number  "2". 

50-66 

Left-justified  format  - 12(D4.1). 

67-80 

Comment  field. 

Data  cards  to 

i 

input  the  X 

coordinate  of  each  station  follow 

initialization  card  21.  The  format  12(D4.1)  calls  for  ”12" 
fields  per  card.  The  "D4.1"  means  that  signed  floating  point 
numbers  with  four  places  before  the  decimal  point,  the  decimal 
point  and  one  place  after  the  decimal  point  are  to  be  read. 


22 


1-4 

10 

12 

15-18 

19-22 

34 

50-66 

67-80 


The  number  "39". 

The  number  "1". 

The  letter  "R". 

Integer  giving  the  number  of  stations. 
The  number  "34". 

The  number  "2". 

Left-justified  format  - 12(D4.1). 
Comment  field. 


Data  cards  to  input  the  Y coordinate  of  each  station  follow 
initialization  card  22.  The  format,  12(D4.1),  is  explained 
above  under  initialization  card  21. 


23 


1-4 

10 

13 

15-18 


The  number  "40". 

The  number  "1". 

The  letter  "Z". 

Integer  giving  the  number  of  stations. 


i 
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INITIALIZATION  CARD  ; COLUMNS 

f 

19-22  ! 

! 1 
34 

67-80  | 

24  1-4 

10  | 

I 

13 

15-18  j 
19-22  j 
34 

67-80  | 

25  ! 1-4 

10 

13 

15-18 

19-22 

34 

67-80 

26  1-4 

10 

13 

15-18 

! 

19-22 

34 

67-80 

27  1-4 
10 

13  I 

15-18  ! 

19-22 

34 

67-80  | 

28  1-4 
10 


CONTENT  

The  number  "34". 

The  number  ”2". 

Comment  field 
The  number  ”41". 

The  number  ”1". 

The  letter  "Z". 

Integer  giving  the  number  of  stations . 
The  number  "34". 

The  number  "4". 

Comment  field. 

The  number  "42". 

The  number  "1". 

The  letter  "Z". 

Integer  giving  the  number  of  stations. 
The  number  "34". 

The  number  "4". 

Comment  field. 

The  number  "43". 

The  number  "1". 

The  letter  "Z". 

Integer  giving  the  number  of  stations . 
The  number  "34". 

The  number  "4". 

Comment  field. 

The  number  "44". 

The  number  "1". 

The  letter  "Z". 

Integer  giving  the  number  of  stations. 
The  number  "34". 

The  number  "2". 

Comment  field. 

The  number  "45". 

The  number  "1". 
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INITIALIZATION  CARD 

COLUMNS 

CONTENT 

13 

The  letter  "Z". 

15-18 

Integer  giving  the  number  of  stations. 

19-22 

The  number  "34". 

34 

The  number  "4". 

67-80 

Comment  field. 

29  | 

1-4 

The  number  "46". 

] 

10 

The  number  "1". 

13 

The  letter  "Z". 

15-18 

Integer  giving  the  number  of  stations. 

19-22 

. 

The  number  "34". 

34 

The  number  "2". 

67  80 

Comment  field. 

30 

1-4 

The  number  "47". 

10 

The  number  "1". 

13 

The  letter  "Z". 

15-18 

Integer  giving  the  number  of  stations . 

19-22 

The  number  "34". 

34 

The  number  "4". 

67-80 

Comment  field. 

31 

1-4 

The  number  "48". 

10 

The  number  "1". 

13 

The  letter  "Z", 

15-18 

Integer  giving  the  number  of  stations . 

19-22 

The  number  "34". 

34 

The  number  "4". 

j 67-80 

Comment  field. 

32 

1-4 

The  number  "49". 

10 

The  number  "2". 

12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  stations. 

| 19-22 

The  number  "34". 

| 40 

The  number  "4". 

f 
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i 


INITIALIZATION  CARD 

COLUMNS 

CONTENT 

41 

The  letter  ”R”. 

50-66 

Left- justified  format  - 16(14) . 

67-80 

Comment  field. 

The  table  to  input  the  number  of  resources  of  each  resource 
type  at  each  station  follows  initialization  card  32.  There  is 
usually  one  input  card  per  station  in  this  data  set.  Each 
card  contains  the  number  of  resources  of  each  resource  type  at 
a station  read  in  under  the  format  16(14)  and  an  integer  right- 
justified  in  columns  71  and  72  giving  the  number  of  resource 
If  there  are  more  than  16  resource  types,  the  first  card  for 
a station  would  contain  the  number  of  resources  of  the  first 
16  types  and  a C keypunched  in  column  72.  The  next  card 
would  contain  the  number  of  resources  of  the  remaining  types 
and  the  number  of  fields  to  be  read  keypunched  in  column 
71  and  72. 


33 


1-4 

10 

12 

15-18 

19-22 

40 

41 

50-66 

67-80 


The  number  ”50". 

The  number  ”2”. 

The  letter  ”R”. 

Integer  giving  the  number  of  stations 
\ The  number  ”34”. 

The  number  ”4”. 

The  letter  "R". 

Left- justified  format  - 8(14). 

Comment  field. 


The  table  to  input  the  number  of  crews  during  each  shift  at  each 
station  follows  initialization  card  33.  There  is  one  input  card 
per  station  in  this  data  set.  Each  card  contains  the  number 
of  crews  during  each  shift  for  a station  under  the  format 
8(14)  and  an  integer  right- justified  in  columns  71  and  72  giving 
the  number  of  shifts . The  number  of  shifts  cannot  be  greater 


The  number  ”51”. 
The  number  ”1”. 


than  8. 

} 

34 

1-4 

O 

r— 1 

13 

15-18 

The  letter  ”Z”. 

Integer  giving  the  number  of  stations 


INITIALIZATION  CARD 

COLUMNS 

CONTENT 

19-22 

The  number  "34", 

34 

The  number  "4". 

67-80 

Comment  field. 

35 

1-4 

The  number  "52". 

10 

The  number  "1". 

13 

The  letter  "Z". 

15-18 

Integer  giving  the  number  of  stations. 

19-22 

The  number  "34". 

36 


34 

67-80 

1-4 


The  number  "2". 
Comment  field. 
The  number  "53" 


37 


38 


I 

i 


12 

50-66 

67-80 

1-4 

10 

13 

15-18 

19-22 

23-26 

27-30 

40 

67-80 

1-4 

10 

13 

15-18 

19-22 

34 

67-80 


The  letter  "R". 

Left- justified  integer  giving  the  total 
number  of  weekend  shifts  and  weekday 
I shifts. 

Comment  field. 

The  number  "54". 

! The  number  "2". 

j 

The  letter  "Z". 

Integer  giving  the  number  of  stations. 

i 

; The  number  "34". 

| 

Integer  giving  the  total  number  of  shifts, 
i The  number  "53". 

I 

The  number  "2". 

Comment  field. 

The  number  "55". 
j The  number  "1". 

The  letter  "Z". 

Integer  giving  the  number  of  shifts . 

The  number  "53". 

The  number  "2". 

Comment  field. 

| 

I 

} 


i 

f 

t 

J 
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CONTENT 


INITIALIZATION  CARD  COLUMNS 

39  | 1-4 

! 10 

i 

12 

15-18 

19-22 

34 

i 

50-66 
t 67-80 


The  number  "56". 

The  number  "1". 

The  letter  "R". 

Integer  giving  the  number  of  shifts . 
The  number  "53". 

The  number  "2". 

Left-justified  format  - 8(H2.2). 
Comment  field. 


One  data  card  follows  initialization  card  39  to  input  the  times 
that  the  shifts  end.  Times  that  weekday  shifts  end  are  keypunched 
forst  with  the  times  that  weekend  shifts  end  keypunched  last. 

The  format,  8(H2.2)  indicates  a maximum  of  eight  fields  on 
the  card  with  the  times  given  in  decimal  hours . 


40 


41 


42 


1-4 

The  number  "57". 

10 

The  number  "1". 

i 13  | 

The  letter  "Z". 

15-18  | 

Integer  giving  the  number  of  shifts. 

19-22  j 

The  number  "53". 

34  j 

The  number  "2". 

67-80  j 

Comment  field. 

1-4 

| 

The  number  "58". 

12 

The  letter  "R". 

50-66 

The  number  "5",  left- justified. 

67-80 

Comment  field. 

1-4 

The  number  "59". 

10 

The  number  "1". 

12 

The  letter  "R". 

15-18 

The  number  "5". 

19-22 

The  number  "58". 

34 

| The  number  "2". 

50-66 

Left-justified  format  - 5(H2.2). 

67-80 

Comment  field. 

1 

l 
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INITIALIZATION  CARD 


COLUMNS 


CONTENT 


One  data  card  follows  initialization  card  42  to  input  tolerance 
times  in  decimal  hours „ Note  that  there  are  always  5 tolerance 
times.  The  first  tolerance  time  will  have  the  greatest  value 
since  severity  level  1 is  the  lowest  priority. 


1-4 

The  number  "60". 

| 

10 

The  number  "1". 

i 

12 

The  letter  "R". 

15-18  ! 

1 

The  nianber  "5". 

19-22  | 

The  number  "58", 

34  | 

The  number  "2". 

50-66  | 

Left-justified  format  - 5(H2.2). 

67-80  i 

Comment  field. 

One  data  card  follows  to  input  search  tolerance  times  in 
decimal  hours . Again  there  are  always  5 search  tolerance  times 
and  the  first  will  have  the  greatest  value  since  severity 

level  1 is  the  lowest  priority. 


44 


45 


12 

50-66 

67-80 

1-4 

10 

12 

15-18 

19-22 

50-66 

67-80 


The  number  "61". 

The  letter  "R". 

Left- justified  integer  giving  the 
number  of  rows  in  the  Resource 
Capability  Matrix  (Figure  IV- 3) . 

Comment  field. 

The  number  "62". 

The  number  "1". 

The  letter  "R". 

Integer  giving  the  number  of  rows 
| in  the  Resource  Capability  Matrix 

| The  number  "61". 

| Left- justified  format  - 6(012). 

| Comment  field. 


Data  cards  to  input  the  Resource  Capability  Matrix  follow 
initialization  card  45.  The  format,  6(012)  indicates  6 fields 
per  card  with  12  columns  per  field.  Each  row  of  the  Resource 
Capability  Matrix  is  represented  by  one  octal  number.  (See 
Figure  TV- 3) . The  Resource  Capability  Matrix  must  be  changed 
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SAMPLE  RESOURCE  CAPABILITY  MATRIX 


•H  03 

r-H 

•H  dJ 
X5  U 
03  i 
CL  C 
03  O 
U C 


ro  a; 
p 
p. 


t''. 


B 


O *H 
P-«  P 


bO 

P 

£ 


bO 

.a 

■s 


T5 

<y 

rH 

I 

<S' 


FIGURE  IV- 3 1 - indicates  capability 

SAMPLE  RESOURCE  CAPABILITY  MATRIX  ° ' indicates  non-capability 


T3 

<D 


Right -justified 
Octal  Number  Representing 
Row 

157760 

114760 

114760 

000160 

157761 

157760 

016760 

000760 

LLLLL  I 

116677 

016677 

r*- 

o 

o 

o 

o 

LLLLLl 

177775 

114777 

LLLLLl 

014777 

177777 

177017 

RESOURCE  TYPE 

to 

O 

O 

O 

O 

rH 

O 

O 

O 

rH 

rH 

rH 

rH 

rH 

i — 1 

rH 

rH 

rH 

rH 

rH 

CM 

LO 

X 

X 

o 

o 

o 

o 

O 

o 

O 

o 

rH 

rH 

rH 

rH 

rH 

O 

rH 

rH 

rH 

rH 

rH 

vD 

o 

o 

o 

o 

O 

o 

o 

o 

rH 

i — 1 

rH 

i — 1 

rH 

rH 

rH 

i — 1 

rH 

rH 

rH 

O 

to 

r— 1 

u 

o 

o 

o 

o 

O 

o 

o 

o 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

CJ 

s 

1 — 1 

rH 

1 — 1 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

i — 1 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

O 

u 

1— 1 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

O 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

i — 1 

O 

O 

O 

rH 

rH 

rH 

rH 

I — 1 

rH 

O 

82/95-P 

r— 1 

rH 

rH 

O 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

O 

i — 1 

rH 

rH 

rH 

rH 

rH 

O 
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82/95 

rH 

rH 

rH 

O 

rH 

rH 

rH 

rH 

rH 

rH 

i — 1 

O 

rH 

rH 

rH 

rH 

i — 1 

rH 

O 

MRB/MSB 

rH 

O 

O 

O 

i — 1 

rH 

O 

O 

rH 

O 

O 

O 

i — 1 

i — 1 

O 

i — 1 

O 

rH 

rH 

36  's 

rH 

O 

o 

O 

i — 1 

rH 

rH 

O 

i — 1 

rH 

rH 

O 

i — 1 

rH 

O 

i — 1 

O 

rH 

i — 1 

52 's 

rH 

i — 1 

rH 

o 

rH 

rH 

rH 

O 

rH 

rH 

rH 

O 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

44 's 

rH 

rH 

rH 

o 

rH 

rH 

rH 

O 

rH 

rH 

rH 

o 

rH 

rH 

rH 

rH 

rH 

rH 

rH 

C/) 

rH 

O 

O 

O 

o 

O 

O 

O 

O 

i — 1 

O 

O 

o 

rH 

rH 

O 

rH 

O 

rH 

rH 

(f ) 

O 

TO 

rH 

O 

O 

o 

rH 

rH 

o 

O 

i — 1 

o 

O 

o 

rH 

rH 

O 

i — 1 

O 

rH 

rH 

40' s 

rH 

rH 

rH 

o 

rH 

I — 1 

o 

O 

rH 

rH 

O 

o 

rH 

rH 

rH 

rH 

o 

rH 

rH 

For 

Attribute 

NEED:  Towed  - 30  < L(CASE) 
< 65' 

NEED:  Towed  - 65'  < 
L(CASE)  < 100' 

NEED:  Towed  - 100'  < 
L(CASE)  < 200' 

NEED:  Towed  - L(CASE) 
a 200' 

NEED:  Evacuate  POB’s  5 < 
POB(CASE)  <10 

NEED:  Evacuate  POB's  10  < 
P0B(CASE  )<  18 

NEED:  Evacuate  POB's  18  < 
P0B(CASE)<  25 

NEED:  Evacuate  POB's 
POB (CASE)  > 25 

O'  < SWELL (CASE)  < 5' 

O 

rH 

V 

S' 

d 

VI 
LO 

10  < SWELL (CASE)  < 20' 

SWELL (CASE)  > 20' 

WIND (CASE)  < 60 

WIND (CASE)  > 60 

VIS (CASE)  = 0 

VIS  (CASE)  > 0 

AIR(CASE)  < 20° 

AIR(CASE)  > 20° 

0 < OFSHR(CASE)  < 1/2 

Row 

Number 

CV4 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

o3  i 

a o 
o c 


i— I o 


to 

> 

a 

3 


3. 


.s 

p 

c 

o 

u 


Right-justitied 
Octal  Number  Representing 
Row 

177777 

157777 

116777 

016777 

000777 

RESOURCE  TYPE 

to 

3 

r— I 

- 

rH 

rH 

tH 

|h  H 52 

H 

rH 

rH 

rH 

rH 

HU  16  1 

- 

ip 

rH 

H 

rH 

O 

to 

tH 

u 

H 

rH 

H 

rH 

H 

u 

s 

- 

rH 

rH 

- 

tH 

MEC 

rH 

rH 

H 

rH 

H 

rH 

rH 

H 

tH 

H 

82/95-P 

rH 

i — 1 

H 

rH 

H 

LO 

cr> 

rsj 

oo 

rH 

rH 

H 

rH 

rH 
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mrb/msb! 

rH 

rH 

O 

O 

O 

36  's 

rH 

rH 

rH 

rH 

O 

(/) 

CO 

LO 

rH 

H 

rH 

rH 

O 

i — 1 

H 

rH 

rH 

O 

If) 

[>~ 
t — 1 

tH 

O 

O 

O 

O 

30 's 

rH 

rH 

O 

o 

o 

40  's 

tH 

rH 

rH 

o 

o 

For 

Attribute 

1/2  < OFSHR(CASE)  < 5 

5 < OFSHR(CASE)  < 10 

10  < OFSHR(CASE)  < 20 

o 

LO 

V 

g? 

to 

Uh 

o 

vi 

o 

CO 

OFSHR(CASE)  > 50 

Row 

Number 

39 

40 

41 

42 

43 

INITIALIZATION  CARD 


COLUMNS 


CONTENT 


if  there  is  a change  in  the  number  of  resource  types  and  if  there 
is  a change  in  the  capable/non-capable  status  of  any  matrix 
element.  Of  course,  it  would  also  need  to  be  changed  if  more 
rows  were  added,  but  this  would  also  require  a change  in  the 
computer  programming  code  in  Subroutine  CRES . 


46 


47 


1-4 

12 

50-66 

67-80 

1-4 

10 

12 

15-18 

19-22 

50-66 

67-80 


The  number  ”63”. 

The  letter  ”R". 

Left-justified  integer  giving  the 
number  of  resource  types. 

Comment  field. 

The  number  ”64”. 

The  number  ”1”. 

The  letter  "R". 

Integer  giving  the  number  of  resource  types. 
The  number  ”63". 

Left- justified  format  - 6(012). 

Comment  field. 


Data  cards  follow  initialization  card  47  to  input  the  permanent 
attribute,  "MASK”.  MASK(I) , where  I is  the  ordinal  designation 
of  a particular  resource  type,  is  used  in  Subroutine  CRES  in 
determining  what  resource  types  can  serve  a case.  After  "ANDing” 
the  appropriate  rows  of  the  Resource  Capability  Matrix  (see  Sub- 
routine CRES  in  Section  XI ? Part  III),  each  MASK(I)  is  "ANDed”  with 
that  product  to  determine  if  the  Ith  resource  type  can  serve 
the  case.  From  the  above  explanation  of  the  function  of  "MASK”, 
the  input  of  "MASK”  can  be  understood.  (See  Figure  IV-4)  . For 
example,  MASK(l)  should  have  all  bits  of  the  36-bit  UNIVAC  1108 
word  zeroed  out  except  the  one  representing  the  first  resource  type 
- thus  the  right  justified  octal  number,  100000.  TT~ the  number  of 
resource  types  was  increased  to  17,  MASK(l)  would  be  input  as  200000, 
MASK(2)  would  be  input  as  100000,  etc. 


48 


1-4 


The  number  "65”. 


12 

50-66 


The  letter  "R”. 

Left-justified  integer  giving  to  maximum 
number  of  SIS  (CASE) , number  of  resources 
operating  in  parallel  on  a long  search 
case;  the  maximum  number  is  presently 
10. 
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FIGURE  IV-4 

'MASK"  INPUT  FOR  SIXTEEN  RESOURCE  TYPES 




INITIALIZATION  CARD 

COLUMNS 

CONTENT 

- 

67-80 

Comment  field. 

49 

1-4 

The  number  "66". 

10 

The  number  "2". 

12 

The  letter  "R". 

15-18 

Integer  giving  the  maximum  SIS (CASE). 

19-22 

The  number  "65". 

40 

The  number  "2". 

41 

The  letter  "R". 

| 50-66 

Left-justified  format  - 10(U1.3). 

67-80 

Comment  field. 

The  ragged  table  to  input  the  fractional  split  of  the  total 
search  miles  on  a case  as  a function  of  SIS (CASE)  follows  initiali- 
cation  card  49.  The  format  10(U1.3)  indicates  10  fields  per 
card  with  5 columns  in  each  field.  The  U means  unsigned  numbers 
must  be  input.  The  first  data  card  inputs  the  percentage  of 
search  miles  assigned  to  the  resource  when  SIS (CASE)  = 1, 
the  second  data  card  inputs  the  fractional  split  of  the  total 
search  miles  when  SIS (CASE)  = 2,  the  third  data  card  inputs 
the  fractional  split  when  SIS  (CASE)  = 3,  etc.  Each  of  the 
data  cards  must  have  an  integer  right- justified  in  columns  71 
and  72  to  indicate  how  many  fields  will  be  read  from  the  card. 


50 

1-4 

The  number  "67". 

13 

The  letter  "Z" 

67-80 

Comment  field. 

51 

1-4 

The  number  "68". 

12 

The  letter  "R". 

50-66 

Left- justified  integer  giving  the 
number  of  patrolling  cutters. 

67-80 

Comment  field. 

52 

1-4 

The  number  "69". 

10 

The  number  "1". 

12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  patrolling 
cutters . 

19-22 

The  number  "68". 

65- 


INITIALIZATION  CARD 

COLUMNS  f 

CONTENT 

34  ! 

The  number  "4". 

50-66  j 

Left-justified  format  - 18(14). 

67-80  ' 

Comment  field. 

Data  cards  follow  to  input  the  ordinal  designations  of  the 
patrolling  cutters  under  the  format  18(14). 

53 

1-4 

The  number  "70". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

54 

1-4 

The  number  "71". 

12 

The  letter  "R". 

50-66 

Left- justified  integer  giving  the 
option  for  CL  (See  OPSIM  Definitions , 
Section  II,  Part  II). 

67-80 

Comment  field. 

55 

1-4 

The  number  "72". 

12 

The  letter  "R". 

50-66 

Left- justified  integer  giving  the 
option  of  COSTO  (See  OPSIM  Defi- 
nitions, Section  II,  Part  II). 

67-80 

Comment  field. 

56 

1-4 

The  number  "73". 

12 

The  letter  "R". 

50-66 

Left- justified  integer  giving  the  district 

67-80 

Comment  field. 

57 

1-4 

The  number  "74". 

12 

The  letter  "R". 

50-66 

Left-justified  floating  point  number 
expressed  in  decimal  days  giving  EPSLN, 
a small  time  delay  for  causing  the 
Endogeneous  Event  NOTE  for  all  but  the 
first  long  search  resource. 

67-80 

Comment  field. 

58 

1-4 

The  number  "75". 

5-8 

The  number  "80". 
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INITIALIZATION  CARD 

COLUMN 

CONTENT 

13 

The  letter  "Z". 

67-80 

Comment  field. 

59 

1-4 

The  number  "81". 

12 

The  letter  "R". 

50-66 

I 

| 

Left-justified  floating  point  number 
expressed  in  nautical  miles  giving 
the  distance  offshore  where  the  hand- 
off  for  a two-part  tow  takes  place. 

67-80 

Comment  field. 

60 

1-4 

The  number  "82". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the 
increment  to  the  priority  of  an 
interrupted  case. 

67-80 

Comment  field. 

61 

1-4 

The  number  "83". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the 
day  of  the  week  on  which  the  simu- 
lation begins  (Monday  = 1 , Tuesday 
= 2,  etc.) 

67-80 

Comment  field. 

62 

1-4 

The  number  "84". 

5-8 

The  number  "85". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

63 

1-4 

The  number  "86". 

12 

The  letter  "R". 

50-66 

Left-justified  floating  point  number 
giving  the  number  of  looks  at  priority 
reevaluation. 

67-80 

Comment  field. 

64 

1-4 

The  number  "87", 

5-8 

The  number  "98". 

-67- 


INITIALIZATION  CARD 

COLUMNS 

CONTENT 

13 

The  letter  "Z". 

67-80 

Comment  field. 

65 

1-4 

The  number  ”99”. 

12 

The  letter  "R". 

50-66 

Left- justified  integer  giving  the 
number  of  weekday  shifts. 

67-80 

Comment  field. 

66 

1-4 

The  number  "100". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the 
number  of  weekend  shifts. 

67-80 

Comment  field. 

67 

1-4 

The  number  "101". 

12 

The  letter  "R". 

50-66 

Left- justified  floating  point  number 
giving  the  percentage  of  search  miles 
desirable  to  achieve  by  each  resource 
on  the  first  day  of  a long 
search. 

67-80 

Comment  field. 

68 

1-4 

The  number  "102". 

12 

The  letter  "R". 

50-66 

Left-justified  floating  point  number 
giving  the  percentage  of  search  miles 
desirable  to  achieve  by  each  resource 
on  any  but  the  first  day  of  a long  search 

67-80 

Comment  field. 

69 

1-4 

The  number  "103". 

12 

The  letter  "R". 

50-66 

Left-justified  floating  point  number 
giving  the  probability  that  the 
priority  will  decrease  when  reevaluated. 

67-80 

Comment  field. 

70 

1-4 

The  number  "104". 

12 

! The  letter  "R". 

/ 
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INITIALIZATION  CARD 

COLUMNS 

CONTENT 

50-66 

Left-justified  floating  point  number 
giving  the  probability  that  the  priority 
will  increase  when  reevaluated. 

67-80 

Comment  field. 

71 

1-4 

The  number  "105". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

72 

1-4 

The  number  "106". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the 
option  for  the  resource  assignment 
policy  (See  OPSIM  Definitions,  Section 
II , Part  II) . 

67-80 

Comment  field. 

73 

1-4 

The  number  "107" 

12 

The  letter"!!". 

50-66 

Left-justified  floating  point  number 
expressed  in  decimal  days  giving  the 
time  for  sunrise. 

67-80 

Comment  field. 

74 

1-4 

The  number  "108". 

12 

The  letter  "R". 

50-66 

! 

V 

Left-justified  floating  point  number 
expressed  in  decimal  days  giving  the 
time  for  sunset. 

67-80 

Comment  field. 

75 

1-4 

The  number  "109". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

76 

1-4 

The  number  "110". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the  priority 
level  to  which  a CASE  is  raised  while 

; a short  search  is  being  served. 

i 

I 

\ 
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INITIALIZATION  CARD  ’ 

COLUMNS 
■ 1 

CONTENT 

67-80 

1 

1 Comment  field. 

77 

1-4 

The  number  "111". 

12 

The  letter  "R". 

50-66 

Left- justified  floating  point  number 
expressed  in  decimal  days  giving  the 
hook-up  time  on  a tow  case. 

67-80 

Comment  field. 

78 

1-4 

The  number  "112". 

5-8 

The  number  "114". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

79 

1-4 

The  number  "115". 

12 

The  letter  "R". 

50-66 

Left- justified  floating  point  number 
expressed  in  nautical  miles  per  day 
giving  the  tow  speed  of  resources  if 
L(CASE)  < 26  feet. 

67-80 

Comment  field. 

80 

1-4 

The  number  "116". 

12 

The  letter  "R". 

50-66 

Left- justified  floating  point  number 
expressed  in  nautical  miles  per  day 
giving  the  tow  speed  of  resources 
if  L(CASE)  > 26  feet. 

67-80 

Comment  field. 

81 

1-4 

The  number  "117". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

82 

1-4 

The  number  "118". 

12 

The  letter  "R". 

50-66 

Left- justified  floating  point  number 

expressed  in  decimal  days  giving  the 
hours  before  sunrise  when  held  over 
long  search  cases  are  examined  for 
resource  assignment. 
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INITIALIZATION  CARL 

COLUMNS 

CONTENT 

67  -80 

Comment  field. 

83 

1-4 

The  number  "119". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

84 

1-4 

The  number  "120". 

10 

The  number  "1". 

12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  resource  types . 

19-22 

The  number  "23". 

34 

The  number  "4". 

50-66 

Left-justified  format  - 16(14). 

67-80 

Comment  field. 

Data  cards  follow  initialization  card  84  to  input  indicators  (0 
if  resource  type  is  a boat;  1 if  resource  type  is  an  airplane)  for 
each  resource  type  under  the  format  16(14). 

85 

1-4 

The  number  "121". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

86 

1-4 

The  number  "122". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

87 

1-4 

The  number  "123". 

12 

The  letter  "R". 

50-66 

i 

i 

j 

Left-justified  integer  giving  the  maximum 
number  of  OPFAC(CASE),  the  station  of 
the  case  input  from  the  Exogenous  Event 
Tape . 

67-80 

: 

Comment  field. 

88 

1-4 

] 

The  number  "124". 

1 

10 

The  number  "1". 

12 

The  letter  "R". 
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INITIALIZATION  CARD 

j COLUMNS 

CONTENT 

15-18 

Integer  giving  the  maximum  number  of 

OP  FAC  (CASE) . 

19-22 

The  number  "123". 

34 

The  number  "4". 

50-66 

Left-justified  format  - 18(14). 

67-80 

Comment  field. 

Data  cards 

follow  to  input  the  station  conversion  table  under 

the  format 

18(14) . 

89 

1-4 

The  number  "125". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the 
logical  unit  number  on  which  the  case 
attributes  will  be  written  for  Quick 
Query. 

67-80 

Comment  field. 

90 

1-4 

The  number  "126". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the 
minimum  priority  at  which  a queued 
need  or  case  is  served  by  an  idle 
capable  resource  regardless  of  the 
resource ' s type . 

67-80 

Comment  field. 

91 

1-4 

The  number  "127". 

10 

The  number  "1". 

13 

The  letter  "Z". 

15-18 

Integer  giving  the  number  of  resources 

19-22 

The  number  "1". 

34 

The  number  "2". 

67-80 

Comment  field. 

92 

1-4 

The  number  "128". 

! 10 

The  number  "1" 

12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  resource 

72- 


INITIALIZATION  CARD 

COLUMNS 

■ — — — — 

CONTENT 

19-22 

The  number  "23". 

34 

The  number  "4". 

50-66 

Left-justified  format,  16(14). 

67-80 

Comment  field. 

Data  cards  follow  to  input  indicators  for  each  resource  type 
under  the  format  16(14).  (0  for  small  vessels,  1 for  cutters, 

2 for  C-130's  and  3 for  aircraft). 


93 


1-4 

10 

12 

15-18 

19-22 

34 

50-66 

67-80 


J The  number  "129". 

! The  number  "1". 
i The  letter  "R". 

| Integer  giving  the  number  of  resource  types. 
The  number  "23". 

The  number  "2". 

Left-justified  format,  7(H3.6). 

| Comment  field. 


Following  initialization  card  93  are  the  data  cards  to  input  a 
delay  time  for  each  resource  type  under  the  format,  7(H3.6).' 


94 


95 


96 


1-4 

12 

50-66 


67-80 
| 1-4 

10 
13 

15-18 

19-22 

34 

67-80 

1-4 


| The  number  "130". 

; The  letter  "R". 

j Left -justified  floating  point  number 
j giving  the  amount  of  time  in  decimal  days 
between  check-in  times  when  a 'covering' 
resource  examines  the  queue. 

Comment  field. 

The  number  "131". 

The  number  "1". 

The  letter  "Z". 

I Integer  giving  the  number  of  stations. 

The  number  "34". 

The  number  "2". 

Comment  field. 

The  number  "132". 
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INITIALIZATION  CARD  | COLUMNS 

CONTENT 

1 

: 10 

The  number  "1". 

I 12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  stations 

19-22 

The  number  "34 ". 

34 

The  number  "4". 

50-66 

Left-justified  format,  18(14). 

67-80 

i Comment  field. 

Data  cards  follow  initialization  card  96  to  input  the  group 
number  of  each  station  under  the  format,  18(14). 


97 

j 1-4 

The  number  "133". 

10 

The  number  "1". 

13 

The  letter  "Z". 

15-18 

Integer  giving  the 

number  of 

stations 

19-22 

The  number  "34". 

34 

The  number  "2". 

67-80 

Comment  field. 

98 

1-4 

i The  number  "134". 

10 

The  number  "1". 

13 

• The  letter  "Z" . 

15-18 

Integer  giving  the 

number  of 

stations 

19-22 

The  number  "34". 

34 

The  number  "2". 

67-80 

; Comment  field. 

99 

1-4 

’ The  number  "135". 

. 13 

The  letter  ”Z". 

67-80 

Comment  field. 

100 

1-4 

The  number  "136". 

13 

; The  letter  "Z". 

67-80 

Comment  field. 

101 

1-4 

Tie  number  "137". 

13 

The  letter  "Z". 
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INITIALIZATION  CARD 

COLUMNS 

CONTENT 

67-80 

Comment  field. 

102 

1-4 

The  number  ”138". 

12 

The  letter  ”R”. 

50-66 

Left- justified  integer  giving  the 
number  of  groups . 

67-GO 

Comment  field. 

103 

1-4 

The  number  ”139”. 

5-8 

The  number  ”151”. 

10 

The  number  ”1". 

13 

The  letter  ”Z”. 

15-18 

Integer  giving  the  number  of  groups. 

19-22 

The  number  ”138”. 

34 

The  number  ”2”. 

67-80 

Comment  field. 

104 

1-4 

The  number  ”152”. 

5-8 

The  number  ”155”. 

13 

The  letter  ”Z”. 

67-80 

Comment  field. 

105 

1-4 

The  number  ”156”. 

12 

1 The  letter  ”R”. 

i 

50-66 

Left-justified  integer  giving  the  number 
of  distributions  output  in  REPORT 
DSTRIB. 

67-80 

Comment  field. 

106 

1-4 

The  number  ”157”. 

5-8 

The  number  ”167”. 

10 

The  number  ”1”. 

13 

The  letter  ”Z”. 

15-18 

Integer  giving  the  number  of  distributions 
output  in  REPORT  DSTRIB. 

19-22 

| The  number  ”156”. 

34 

The  number  ”2”. 

67-80 

: Comment  field. 

I 


75- 


initialization  card 

COLUMNS 

CONTENT 

107 

1-4 

The  number  "168". 

13 

The  letter  "Z". 

67-80 

Comment  field. 

108 

1-4 

The  number  "169". 

12 

The  letter  "R". 

50-66 

Left- justified  integer  giving  the 
number  of  holidays  to  be  read  in.  If 
there  are  no  holidays , input  the  number 
"1"  in  this  field. 

67-80 

Comment  field. 

109 

1-4 

The  number  "170". 

10 

The  number  "1". 

12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  holidays. 
If  there  are  not  holidays , read  in  the 
number  "1"  here. 

19-22 

The  number  "169". 

34 

The  number  "4". 

50-66 

Left- justified  format,  18(14). 

67-80 

Comment  field. 

Data  cards  follow  initialization  card  109  to  read  in  holidays. 
A value  of  -1  should  be  read  in  here  if  there  are  no  holidays. 

110 

! !-4 

The  number  ”171". 

10 

The  number  "1". 

12 

The  letter  "R". 

15-18 

Integer  giving  the  number  of  stations. 

19-22 

The  number  "34". 

34 

The  number  "4". 

50-66 

Left-justified  format,  18(14). 

Following  initialization  card  110  are  the  data  cards  to  input 
PSTTN  for  each  station  under  the  format  18(14).  PSTTN  is  a tag 
to  indicate  if  the  station  can  or  cannot  be  a primary  station. 
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INITIALIZATION  CARD 

COLUMNS 

CONTENT 

111 

1-4 

The  number  "172". 

10 

The  number  "1". 

13 

The  letter  "Z". 

15-18 

Integer  giving  the  number  of  stations. 

19-22 

The  number  "34". 

34 

The  number  "4". 

67-80 

Comment  field. 

112 

1-4 

The  number  "173". 

12 

The  letter  "R". 

50-66 

Left-justified  integer  giving  the  output 
option  for  printing/ not  printing  the 
'case  created'  and  'case  terminated' 
information . 

67-80 

Comment  field. 

113 

1-4 

The  number  "174". 

1 10 

The  number  "1". 

13 

i 

The  letter  "Z". 

15-18 

Integer  giving  the  number  of  stations. 

i 19-22 

The  number  "34". 

| 34 

The  number  "2". 

67-80 

Comment  field. 

114 

j 1-4 

The  number  "175". 

13 

The  letter  "Z". 

67-80 

;! 

i 

Comment  field. 
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IJ . Blank  Card 

A blank  card  must  follow  the  initial  conditions  deck. 

E.  Exogenous  Event  Deck 

The  exogenous  events  may  be  read  from  cards  or  from  magnetic 
tape.  For  efficiency,  OPSIM  is  reading  exogenous  events  from 
magnetic  tape. 

There  are  three  types  of  exogenous  events  in  the  operational  simulator: 
(1)  Exogenous  Event  START,  (2)  Exogenous  Event  OPSIM,  and  (3)  Exogenous 
Event  ENDSIM.  START  occurs  only  once  and  must  be  the  first  event  to 
occur  at  TIME  = 0.0.  OPSIM  occurs  every  time  a case  comes  into  the 
system.  ENDSIM,  an  event  to  end  the  simulation,  occurs  only  once  and 
must  be  the  last  event  on  the  tape.  The  contents  and  format  of  the  exogenous 
tape  event  tape  follow. 


i 
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TYPE  OF  EVENT 

— 

CARD 

COLUMNS 

CONTENT 

START 

1 

3 

The  number  "3"  to  indicate  Exogenous  Evenl 
START. 

(3) 

7 

A zero,  "0",  to  give  the  day  the  event 
occurred . 

i 

10 

A zero,  ”0",  to  give  the  hour  the  event 
occurred . 

OPSIM 

(1) 


[ 1 


2 


12 

1 

i 

3 

4-7 

8-10 

j 

11-12 

13-15 
16-20 
21-25 
26-30 
31-35 
36-40 
41-45 
46-50  [ 
51-55  ! 
56-60  j 
61-65  | 
66-70  1 


I- 5 
6-10 

II- 15 
16-20 


A zero,  "0". 
occurred. 


to  give  the  minute  the  event 


The  number  "1”  to  indicate  Exogenous  Event 
OPSIM. 

Right-justified  integer  giving  the  day 
the  event  occurred. 

Right-justified  integer  giving  the  hour 
the  event  occurred. 

Right-justified  integer  giving  the  minute 
the  event  occurred. 

IDLOC(CASE),  right-justified  integer. 

OPFAC(CASE) , right -justified  integer. 

NOCAS(CASE),  right-justified  integer. 

POB(CASE),  right-justified  integer. 

AIR(CASE) , right- justified  integer. 

WIND(CASE),  right-justified  integer. 

SWELL(CASE),  right- justified  integer. 

VIS(CASE),  right-justified  integer. 

UTYPE(CASE),  right-justified  integer. 

L(CASE),  right-justified  integer. 

FPRI (CASE) , right- justified  integer. 

N,  right- justified  integer. 

N = NNN (CASE)  if  MMM(CASE)  = 0, 

N = NNN (CASE)  + 1 if  MMM(CASE)  > 0 

NNN(CASE) , right-justified  integer. 

MMM(CASE)  right- justified  integer. 

GAMMA (CASE) , right -justified  integer. 

SIS(CASE),  right-justified  integer. 
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TYPE  OF  EVENT 


CARD  I 


COLUMNS 


| 21-25  | 

! 26-30  • 

31-35  [ 


36-40  | 

41-45 
46-50  | 

51-60 


CONTENT 


S2S(CASE)  right- justified  integer. 

TSM(CASE)  , right-justified  integer. 

OFSHR(CASE) , right- justified  integer  given 
in  tenths  of  miles. 

XC(CASE),  right-justified  integer. 

YC(CASE) , right- justified  integer. 

BOX (CASE) , right- justified  integer. 

VALUE (CASE)  right- justified  integer. 


If  a single  resource  case  is  being  input,  card  3 is  read  under 
the  format  (12,  D1.4). 

3 1-2  NEED(CASE)  , right- justified  integer. 

3-8  OST(CASE),  a floating  point  number  ex- 

pressed in  decimal  days  input  under 
the  format  D1.4. 

i 

If  a multi -resource  case  is  being  input,  card  3 is  read  under 

the  format  6(12,  D1.4,  D1.2). 

» 

S 

3 1-2  i NEED(NCTIF) , right- justified  integer. 

3-8  | OST(NOTIF),  a floating  point  number  ex- 

■ pressed  in  decimal  days. 

9-12  j DELTA (NOTI F) , a floating  point  number. 

Note  that  there  are  six  sets  of  the  above  three  fields  on  one 
input  card.  There  is  one  set  per  need  of  a multi -resource 
case  so  that  NEED  (NOTIF) , OST(NOTIF) , and  DELTA (NOTIF)  are  read 
repeatedly  across  the  card  for  all  NNN(CASE)  needs.  More  than 
one  card  may  be  required  to  read  in  all  needs. 

! ITOW(CASE),  right-justified  integer  read 
| in  only  for  multi -resource  cases  with  a tow 
or  escort  need. 

The  number  "2”  to  indicate  Exogenous  Event 
ENDSIM. 

Right- justified  integer  giving  the  last  day 
of  the  simulation. 

| Right -justified  integer  giving  the  last  hour 

of  the  simulation. 

j 

Right-justified  integer  giving  the  last  minute 
of  the  simulation. 


12 


ENDSIM  1 3 


(2) 


j 4-7 
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F.  Data  to  Subroutine  JUMPER 


The  input  data  to  Subroutine  JUMPER  immediately  follows  the 
Exogenous  Event  Deck.  If  the  Exogenous  Event  Deck  is  read  from 
magnetic  tape,  the  data  will  follow  the  blank  card. 

Following  is  a description  of  the  format  and  content  of  the 
JUMPER  data  set: 
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FORTRAN  REPORT  GENERATOR  - INPUT  DECK  ORDER  AND  CARD  FORMAT 
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V.  User's  Guide 


The  computer  code  consisting  of  the  Definition  Deck,  Events  List, 
Exogenous  Events,  Endogenous  Events,  and  subroutines  is  stored  on 
the  FASTRAMD  drum  for  the  UNIVAC  1108  at  NBS  under  the  file  name  CGSIM. 

It  is  assumed  that  the  case  input  or  demand  data  is  stored  on  magnetic 
tape.  (The  large  number  of  cases  for  most  runs  makes  the  use  of  keypunched 
cards  impractical.)  The  unit  or  input  device  on  which  the  tape  is  to 
be  mounted  is  specified  by  letter  on  an  ASG  (assign)  control  card  and 
by  number  in  column  42  of  the  first  card  of  the  Initialization  Deck 
referred  to  as  the  System  Specifications  Card,  The  letter  and  number 
must  be  in  agreement,  with  A corresponding  to  7,  B to  8,  etc.  If  it 
is  desired  to  output  attributes  of  the  individual  cases,  the  system 
variable  STAPE  must  be  set  equal  to  the  number  of  the  output  device. 

If  this  number  corresponds  to  a tape  drive,  there  must  be  an  ASG 
control  card  assigning  the  appropriate  tape. 

A sample  run  deck  will  now  be  described.  The  reader  is  referred 
to  Figure  V-l.  The  following  symbols  will  be  used: 

@ = keypunch  both  a seven  and  an  eight  in  column  one 
A = blank 

A complete  description  of  the  individual  cards  follows : 

Card  1: 

D is  the  priority  of  the  run . The  number  of  tapes , execution  time , and 
the  number  of  output  pages  determine  the  priority  of  a run. 

RUN  is  simply  the  indication  of  a RUN  card. 
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NAMEFG  is  the  six  character  user  name. 


RUNID  is  a five  digit  charge  number. 

WW  is  the  maximum  time  in  minutes . Execution  terminates  abruptly 
if  WW  is  exceeded. 

XXX  is  the  maximum  number  of  pages  to  be  output.  Execution 
terminates  if  XXX  is  exceeded. 

Card  2: 

ASG  designates  a tape  assignment. 

A specifies  the  letter  of  the  tape  drive. 

YYYY  is  the  reel  number  of  the  tape  to  be  mounted.  For  Figure  V-l 
this  corresponds  to  the  case  input  data  since  the  number  7 appears  in 
column  42  of  the  System  Specifications  Card. 

Card  3: 

W indicates  the  tape  will  be  written  on. 

C is  the  letter  of  the  tape  drive.  The  variable  STAPE  should  be 
set  to  9 so  that  case  output  will  be  written  on  this  tape. 

ZZZZ  is  the  reel  number  of  the  tape  to  be  mounted.  If  it  is 
desired  to  obtain  a new  tape  for  this  prupose,  an  S is  placed  next  to 
the  W (on  either  side)  and  nothing  is  keypunched  on  the  card  after 
the  letter  C. 

Card  4: 

Keypunched  exactly  as  shown.  This  calls  in  the  Complex  Utility  Routines. 

Card  5: 

Keypunched  exactly  as  shown.  This  brings  the  program  file  CGSIM  into 
the  user  storage. 
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Card  6: 


Keypunch  exactly  as  shown.  This  begins  execution  of  the  program. 

Card  7 : 

This  is  the  System  Specifications  Card  described  in  part  IV  of  the 
Operational  Simulator  documentation.  It  receives  individual  attention 
here  only  to  show  the  correspondence  between  the  7 in  column  42  and  the 
assignment  of  tape  A on  Card  2. 

Initialization.  Blank  Card,  and  JUMPER  Input:  These  were  described 

in  part  IV. 

Last  Card 

Keypunch  exactly  as  shown.  This  indicates  that  the  run  is  finished. 

It  may  at  some  time  be  desirable  to  change  some  portion  of  the 
computer  code.  A complete  detailed  description  of  all  the  control  cards 
needed  to  accomplish  such  a change  is  quite  lengthy  and  involves 
detailed  explanation  of  UNIVAC  1108  control  cards  and  SIMSCRIPT 
techniques.  Instead,  Figure  V-2  will  list  the  formatted  cards  required 
to  change  both  Subroutine  SERVE  and  Endogenous  Event  ARVSN  as  an  example. 
The  new  version  of  the  program  will  exist  in  the  second  file  of  the 
tape  reel  YYYY  mounted  here  on  unit  B. 

Major  points  to  note  in  Figure  V-2  are  as  follows: 

1.  There  is  no  choice  regarding  the  tape  unit  used  by  SIMSCRIPT  to 

output  the  compiled  version  of  the  program,  it  must  be  unit  B. 

2.  The  Definition  Deck  must  preceed  the  routines  being  recompiled. 

3.  A card  with  "$"  in  column  1 must  follow  the  last  routine  being 
recompiled. 
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Figure  V-2 

Run  Deck  to  Revise  SERVE  and  ARVSN 

Card  Column 
Number  1 

@DaRUNaNAMEFG  , RUNID , WW , XXX 
@WaASGaB=YYYY 

@axqtacur 

AAINFaSIMSCO 

@NaXQTaSXM 

Place  the  Definition  Deck  here. 

Place  the  New  Version  of  Subroutine  SERVE  here. 

Place  the  New  Version  of  Endogenous  Event  ARVSN  here. 

$ 

@axqtacur 

aaers 

AAINFACGSIM 

aadelaserve/code 

aadelaxarvsn/code 

aainab 

@NaASMs  *aSERVE , SERVE 
@NA ASM , * aXARVSN , XARVSN 
0AXQTACUR 

aadelaserve 

aadelaxarvsn 

aadeladefsxx 

aapac 

aaoutab 

aatefab 

aatriab 

@afin 
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Figure  V-3 

Execution  of  the  Revised  Program 


Card  Column 
Number  1 

ODaRUNaNAMEFG , RUNI D ,WW , XXX 

@AASGaA=XXXX 

@AASGAB=YYYY 

@AXQTACUR 

A APE  FAB 

AAlNAB 

oaxqtamainxx 

Initialization  Deck 
Blank  Card 
Input  to  JUMPR 

@AFIN 
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4.  Endogenous  Events  are  referred  toon  DEL  (delete)  Cards  and 
ASM  (assemble)  cards  with  an  "X"  preceding  the  name. 

5.  There  are  other  ways  by  which  to  accomplish  the  change  shown 
in  Figure  V-2.  This  is  a reasonable  way,  however,  which  should 

serve  the  purpose  for  users  who  wish  to  avoid  detailed  involvement  with 
SIMSCRIPT  and/or  the  UNIVAC  1108. 

Having  revised  the  code,  it  is  then  desired  to  execute  the  new 
version  of  the  program.  Assuming  the  case  input  tape  to  be  found  on  tape 
reel  XXXX  and  that  STAPE  = 0 so  that  no  case  output  is  desired, 

Figure  V-3  shows  a typical  follow-up  run  to  the  run  shown  in  Figure 
V-2. 

The  process  of  adding  or  deleting  entries  in  the  Definition  Deck  is 
somewhat  complicated.  SIMSCRIPT  compiles  a translator  provided  subroutine 
package  for  every  definition  on  every  card  of  the  Definition  Deck.  Because 
of  the  large  number  of  definitions  required  by  OPSIM,  the  standard 
compilation  and  assembly  procedures  set  up  an  overflow  condition  on  the 
UNIVAC  1108.  The  suggested  "fix"  for  this  overflow  breaks  the  assembled 
version  into  two  parts  which  are  now  arbitrarily  named  A and  B.  Thus, 
one  run  is  required  to  compile,  assemble,  the  list  the  assembled  code 
in  order  to  see  how  to  split  the  code,  and  a second  run  actually  accomplishes 
the  split  via  two  more  assemblies.  An  example  of  the  first  run  is  shown 
in  Figure  V-4. 

The  user  must  next  examine  the  output  from  this  first  run.  A computer 
reproduction  of  a sample  Definition  Deck  is  shown  in  Figure  V-5. 

The  assembly  listing  corresponding  to  this  Definition  Deck 
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FIGURE  V-4 


Run  to  Compile  and  List  Assembly  of  Definition  Deck 


@ DA  RUNANAMEFG , RUN  ID  ,WW , XXX 

@WAASGAB=YYYY 

0AXQTA  CUR 

A A INFA  SIMSC6 

0NAXQTASIM 

Place  the  revised  Definition  Deck  here. 

$ 

@A  XQTA  CUR 
AAERS 

AAINFASIMLIB 

aainab 

@ I AASM , * ADEFSXX , DE FSXX 
@AFIN 
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is  shown  in  Figure  V-6.  The  six-digit  numbers  at  the  left  of  the  listing 
are  line  numbers.  The  entities  and  attributes  appear  in  the  listing 
with  a single  letter  prefix.  The  line  on  which  an  entity  or  attribute 
name  appears  and  all  lines  up  to  the  next  entity  or  attribute  constitute 
a package  which  must  not  be  split.  The  first  four  lines  and  the  last 
line  (line  52)  must  appear  in  both  sections  A and  B.  A "good"  place 
to  split  this  assembly  is  after  line  27.  Figure  V-7  shows  the  run  which 
will  result  in  A containing  lines  1-27  and  52  B containing  lines 
1-4  and  28  - 52.  The  new  version  of  OPSIM  is  then  output  in  the 
second  file  of  reel  number  YYYY. 

Before  concluding  this  part,  some  mention  should  be  made  of 
computer  running  time.  Generally  it  takes  approximately  three  to 
five  minutes  to  compile  all  of  the  OPSIM  routines . The  assembly  process 
requires  approximately  10  minutes . To  compile  and  assemble  one  or  two 
routines  in  a single  computer  run  can  take  as  long  as  two  to  three 
minutes.  As  far  as  execution  times  are  concerned,  a set  of  about  900  real 
cases  occurring  during  the  month  of  July  1968  in  District  1 w^as  simulated 
in  approximately  5 minutes  when  operating  with  109  resources.  When  the 
number  of  resources  was  reduced  to  34,  execution  time  decreased  to  2 1/2 
minutes.  When  the  number  of  resources  was  increased  to  218,  execution 
time  increased  to  approximately  71/2  minutes. 
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FIGURE  V-7 


Splitting  the  Assembly  of  the  Definition  Deck 
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VI.  Interpretation  of  Output 


In  order  to  inteipret  properly*  the  output  produced  by  OPSIM,  it 
is  necessary  to  understand  the  calculations  of  the  various  statistics. 
A complete  list  of  all  statistical  attributes  discussed  herein  is 
given  in  Figure  VI -1.  The  explanation  of  the  collection  of  these 
statistics  will  be  presented  in  like  order;  however,  some  preliminary 
definitions  are  required  first. 


TIME: 

In  the  context  to  follow,  this  will  refer  to  the  total 
time  simulated  for  a given  run. 

NRES: 

The  total  number  of  resources  in  the  district 
being  simulated. 

NSTA : 

The  total  number  of  stations  in  the  district 
being  simulated. 

NWEWDS : 

The  total  number  of  weekend  and  weekday  shifts . 

NRST: 

The  total  number  of  resource  types . 

REST (I ,J) : 

The  total  number  of  resources  of  type  J at  station  I . 

TOTME(K) : 

The  total  simulated  time  occurring  during  shift  X. 
This  attribute  of  WEWDS  is  acoimulated  in  Endogenous 
Event  NUCRU  and  Exogenous  Event  ENDSXM. 

TUTIL(L) : 

The  total  time  during  a particular  shift  fcr  which 
EIAT(L)  f 0.  nils  attribute  of  RES  is  set  to  zero  at 
the  start  of  every  new  shift.  At  the  end  of  a shift 
its  value  is  accumulated  into  UTIL(L)  and  USHF(I,K) 
for  the  appropriate  values  of  I and  X. 
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Following  is  an  explanation  of  the  statistics  collected  in  OPSIM: 


CNRES(CASE)  : 

The  total  number  of  resources  assigned  to  serve 
a case . 

COSTC(CASE) : 

This  is  the  total  cost  of  the  case.  It  is  equal 
to  the  sum  of  COST (IRS)  for  every  resource  IRS 
assigned  to  serve  the  case. 

DMERT  (CASE)  : 

This  is  the  case  demerit  calculated  in  Subroutine 
STATS.  If  (TWAIT-TOL)  < 0,  then  DMERT  =0.0.  If 
(TWAIT-TOL)  > 0,  then  DMERT  is  calculated  as 
follows.  If  OFSHR  > 20  and  PRI  < 2 or  if 
OFSHR  > 20  and  PRI  >2,  then  DMERT  = 2.0  * 
(TWAIT  - TOL).  If  OFSHR  < 20  and  PRI  >2,  then 
DMERT  = 3.0  * (TWAIT  - TOL) . If  OFSHR  > 20 

and  PRI  < 2,  then  DMERT  = TWAIT  - TOL. 

NOINT(CASE) : 

The  total  number  of  times  that  the  resource (s) 
serving  a case  are  interrupted. 

NQUE (CASE) : 

The  total  number  of  times  that  the  case  enters  a 
queue.  This  value  is  increased  by  one  every  time 
that  a need,  tow,  or  search  is  filed  in  the  queue. 

REA  (CASE)  : 

The  reason  the  case  first  enters  a queue.  The  meanings 
of  the  various  values  this  can  assume  are  given  in 
part  II. 

RESA(CASE) : 

This  is  the  first  resource  to  arrive  on  the  scene  of 
the  case. 
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TINT  (CASE) ; 

TQUE(CASE) : 
TQUEl(CASE) : 

TSVC (CASE) : 

WAIT  (CASE) : 
RESA(NOTIF) : 

RESA(NOTE) : 
NCASECRES)  : 


The  total  time  that  some  need,  tow,  or  search  of  the 
case  is  in  the  queue  because  of  an  interrupt.  Time 
starts  to  accumulate  in  this  attribute  as  soon  as  the 
first  need,  tow,  or  search  of  the  case  is  in  interrupt 
status  in  CQUE.  It  ceases  to  accumulate  when  the  last 
need,  tow,  or  search  in  the  queue  because  of  an  interrupt 
is  served. 

Total  time  during  which  at  least  one  need,  tow,  or 
search  of  the  case  is  in  the  queue. 

Total  time  before  the  first  resource  arrives  on  the 
scene  of  the  case  for  which  at  least  one  need,  tow  or 
search  of  the  case  is  in  the  queue. 

Total  time  the  case  is  in  the  system.  A case  is  con- 
sidered "in  the  system"  from  the  time  it  occurs  until 
the 'time  at  which  the  resource  serving  the  last  need, 
tow,  or  search  leaves  the  scene  of  the  case  having 
completed  its  duty. 

Total  time  between  the  occurrence  of  the  case  and  the 
time  that  the  first  resource  arrives  on  scene. 

The  first  resource  to  arrive  on  the  scene  of  the  case 
for  the  purpose  of  serving  a particular  need  or  tow 
NOTIF. 

The  first  resource-  to  arrive  on  the  scene  of  the  case 
for  the  purpose  of  serving  a long  search  NOTE. 

The  total  number  of  times  a resource  is  assigned  to  ser- 
vice. It  is  increased  every  time  a resource  is  assigned  to 
a need,  even  if  it  serves  more  than  one  need  of  the  same  ca,e 
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UTIL(L) : 


AUT(J) : 


AVGTW(STA)  : 


CFTT(STA)  : 


DMRT(STA)  : 


This  attribute  assumes  two  roles  in  the  simulation. 
While  the  simulation  is  in  progress  it  contains 
the  total  time  for  which  EIAT(L)  f 0.  At  the  end 
of  the  simulation  in  ENDSIM  the  value  UTIL(L)  is 
divided  by  TIME.  It  then  represents  average  utiliza- 
tion for  resource  L.  Let  tJTIL(L)l  denote  the  value 
before  the  division  occurs. 

This  is  the  average  utilization  of  resource  type  J. 

It  is  calculated  in  ENDSIM  as  follows: 

NSTA 

AUT(J)  = [ l UTIL(L)  'j/friME*^  REST(I,J)]. 

LeJ  1=1 

The  average  thne  in  hours  that  cases  have  to  wait. 

The  waiting  time  is  attributed  to  the  station  of 
the  first  resource  to  arrive  on  the  scene  of  the 
case. 

The  average  Failure  type  C(TWAIT-TOL)  at  a station 
expressed  in  decimal  hours . This  is  calculated  in 
Subroutine  ENDSIM. 

CFTT (STA)  = TWTOL (STA) 1 *2 4.0) /FAILS (STA) . 

During  the  simulation,  DMRT(STA)  is  an  accumulation 
of  the  case  demerits,  DMERT(CASE),  and  is  accounted  to 
the  station  of  the  first  resource  to  arrive  on  the 
scene  of  the  case.  In  ENDSIM,  to  obtain  the  normalized 
demerit  at  the  station  in  decimal  hours,  DMRT(STA) 
is  replaced  by  (DMRT(STA)  *24 . 0*R) /NCAS (STA)  where  R 
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is  the  sum  of  all  positive  (TWAIT-TOL)  in  the  district 
divided  by  the  sum  of  all  case  demerits  in  the  district. 


FAILl(STA)  , 
FAIL2  (STA)  , 
FAXL3(STA) ; 


NCAS(STA): 

NEEDS (STA) : 
NINTR(STA) : 

NMBRQ(STA): 

NSTBY  (STA)  : 
TWTOL (STA) : 


The  total  number  of  Failure  type  A,  type  B,  and 
type  C respectively  at  a given  station.  FAIL1  and 
FAIL2  are  attributed  to  the  primary  station  of  the 
case.  FAIL3  is  accounted  to  the  station  of  the 
first  resource  to  arrive  on  the  scene  of  the  case. 

The  number  of  cases  for  which  a resource  from  this 
station  was  the  first  resource  to  arrive  on  the  scene 
of  the  case. 

The  number  of  times  resources  from  this  station  were 
assigned  to  service* 

The  number  of  times  resources  from  this  station 
were  interrupted  while  serving  one  case  to  serve 
another  case. 

The  number  of  times  a case,  multi-resource  need  or 
long  search  need  was  queued  at  this  station.  The 
queue  is  attributed  to  the  primary  station  of  the 

case . 

The  number  of  times  that  a standby  was  called  at 
the  station. 

During  the  simulation,  TWTOL (STA)  is  an  accumulation 
of  all  positive  (TWAIT-TOL)  and  is  accounted  to 
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the  station  of  the  first  resource  to  arrive  on  the 
scene  of  the  case.  In  ENDSIM,  to  obtain  the  average 
positive  (TWAIT-TOL)  at  the  station  in  decimal  hours, 
TWTOL (STA) is  replaced  by  TWTOL (STA) 1*  24.0) /NCAS (STA) . 

Let  TWTOL (STA) 1 denote  the  value  before  the  division 
occurs . 

UNPRO(STA) : The  number  of  times  that  a standby  was  called  at  the 
station  but  not  used. 

USE(I):  This  is  the  average  utilization  at  station  I.  It 

is  calculated  in  ENDSIM  as  follows: 

NWWDS  NRST 

USE  (I)  = [ l USHFCljK)1]/ [TIME*  l REST (I ,J) ] . 

K=1  J=1 

USHFI,K):  This  attribute  assumes  two  roles  in  the  simulation. 

During  the  simulation  it  is  an  accumulation  of  TUTIL(L) 

for  "appropriate"  values  of  L.  That  is,  at  the  end  of 

every  shift  K,  the  value  of  TUTIL(L)  is  accumulated 

into  USHF(I,K)  if  resource  L has  STN(L)  = I.  At  the 

end  of  the  simulation  in  ENDSIM,  USHF  (I,K)  is  replaced 

by  the  following  quotient: 

NRST 

USHF  (I  ,K)/  [TOTME(K)*£  REST(I,J)]. 

J=1 

Thus  USHF(I,K)  becomes  average  utilization  during  shift 
K at  station  I.  Let  USHF(I,K)^  refer  to  the  value  of 
USHF Cl ,K)  described  above  immediately  before  the  division 
is  executed. 
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VCT RCSTA) : 


AVUS(K)  : 


AVDRT (GROUP) : 


CS (GROUP) 


FL1 (GROUP) , 
FL2 (GROUP) , 
FL3 (GROUP) : 


VCTR(STA)  is  an  accumulation  of  the  tijne- to -vector 

(TVEC)  of  the  first  resource  to  arrive  on  the  scene 

of  the  case  and  is  accounted  to  the  station  of  that 

resource.  At  the  end  of  the  simulation  in  ENDSIM, 

VCTR(STA)  is  replaced  by  VCTR(STA)  *24.0/NCAS(STA) 

for  the  average  TVEC  in  decimal  hours. 

This  is  the  average  utilization  during  shift  K. 

It  is  calculated  in  ENDSIM  as  follows: 

NSTA  , 

AVUS (K) : = [ l USHF(I ,K) 1] / [TOTME  (K)*NRES] . 

1=1 

AVDRT (GROUP)  is  an  accumulation  of  case  demerits, 
DMERT(CASE),  and  is  accounted  to  the  group  of  the 
station  of  the  first  resource  to  arrive  on  the 
scene  of  the  case.  To  obtain  the  normalized 
demerit  of  the  group  in  decimal  hours,  AVDRT (GROUP) 
is  replaced  by  (AVDRT (GROUP) *24 . 0*R)  / CS (GROUP) 
in  ENDSIM.  R is  the  sum  of  all  positive  (TWAIT-TOL) 
in  the  district  divided  by  the  sum  of  all  case  de- 
merits in  the  district. 

The  number  of  cases  for  which  a resource  from  this 
group  was  the  first  resource  to  arrive  on  the 
scene  of  the  case. 

The  total  number  of  failure  type  A,  type  B and 
type  C respectively  in  a given  group.  FL1  and  FL2 
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INTRP  (GROUP)  : 
NDS (GROUP) : 
NONPR( GROUP) : 
NOSB  (GROUP) : 
TMTAV( GROUP)  : 


TVAVG  (GROUP): 


are  attributed  to  the  group  of  the  primary  station 
of  a case.  FL3  is  attributed  to  the  group  of 
the  station  of  the  first  resource  to  arrive  on  the 
scene  of  a case. 

The  number  of  times  resources  from  this  group  were 
interrupted. 

The  number  of  times  resources  from  this  group  were 
assigned  to  service. 

The  number  of  times  that  a standby  was  called  at  the 
stations  belonging  to  the  group  but  not  used. 

The  number  of  times  that  a standby  was  called  at  the 
stations  belonging  to  the  group . 

During  the  simulation,  IMTAV(GROUP)  is  an  accumulation 
of  all  positive  (TWAIT-TOL)  and  is  accounted  to  the 
group  of  the  station  of  the  first  resource  to  arrive 
on  the  scene  of  the  case.  To  obtain,  the  average 
positive  (TWAIT-TOL)  of  the  group  in  decimal  hours, 
TMTAV( GROUP)  is  replaced  by  TMTAV (GROUP)  *24 . 0/CS 
(GROUP)  in  ENDSIM. 

During  the  simulation,  TVAVG (GROUP)  is  an  accumulation 
of  TVEC  of  the  first  resource  to  arrive  on  the  scene 
of  a case  and  is  accounted  to  the  group  of  the  station 
of  that  resource.  In  ENDSIM,  to  obtain  the  average 
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TWAVG (GROUP) : 

TVEC  of  the  group  in  decimal  hours,  TVAVG (GROUP) 
is  replaced  by  TVAVG(GROUP)  *24.0/CS(GROUP) . 

TWAVG (GROUP)  is  an  accumulation  of  TWAIT (CASE)  and 
is  attributed  to  the  group  of  the  station  of  the 
first  resource  to  arrive  on  the  scene  of  the  case. 

To  obtain  the  average  TWAIT  of  the  group  in  decimal 
hours,  TWAVG (GROUP)  is  replaced  by  TWAVG (GROUP)  *24.0/ 
CS  (GROUP)  in  ENDSIM. 

USEAV (GROUP) : 

This  is  the  average  utilization  of  the  group.  It 
is  calculated  in  ENDSIM  as  follows: 

NWEWDS  , NRST 

USEAV( GROUP)  = [ l l USHF  (I  ,K) 1]  / [TIME*  £ l REST(I,J)] 


MEEN(I) : 

K=1  I e GROUP  J=1  I e GROUP 

The  arithmetic  mean  of  certain  attributes  output 

in  REPORT  DSTRIB.  During  the  simulation,  MEEN(I)  con- 
tains the  sum  of  the  values  of  the  observations . In 
ENDSIM,  this  sum  is  divided  by  the  number  of  observations 
to  obtain  the  mean. 

CNTR(I)  : 

The  number  of  observations  made. 

STDEV(I)  : 

The  standard  deviation  of  certain  attributes  output 
in  REPORT  DSTRIB.  During  the  simulation,  STDEV(I) 
contains  the  sum  of  the  squares  of  the  observation  values . 
In  ENDSIM,  STEEV(I)  is  replaced  by: 

[STDEV(I)/CNTR(I)  ] - [MEEN(I)]  2 
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3 MEEN(I)  is  the  arithmetic  mean  as  explained 
3 after  the  division  in  ENDSIM. 

CAT  1(1)  - 

CATG8  (I) : 

Eight  separate  categories  in  which  to  store  the 
distribution  of  observations  for  output  in  REPORT 
DSTRIB. 

AIRU: 

The  average  utilization  of  aircraft  excluding  C-130's. 

AIRU 

This  is  calculated  in  ENDSIM  as  follows: 

NSTA 

= [ l UTIL  (I)1] /[TIME  *1  l REST  (J,K)  ] 

IeL  J=1  KeM 

where  L is  the  set  of  resources  having  SQTAG(TYPE(I)) 
=3  and  M is  the  set  of  resource  types  having  SQTAG(K) 
=3. 

AVUT0: 

This  is  average  overall  utilization.  It  is  calculated 

BUHL: 

in  ENDSIM  as  follows: 

NWWDS  NSTA 

AVUTO  = [ l l USHF(I,K)  ]/[TIME*NRES]  . 

K=1  1=1 

The  average  utilization  of  small  vessels.  This  is 

calculated  in  ENDSIM  as  follows : 

NSTA 

BUTIL  = [ l UTIL(I) 1] / [TIME  l REST(J,K)] 

IeL  J=1  KeM 

where  L is  the  set  of  resources  having  SQTAG(TYPE(I) )=0 
and  M is  the  set  of  resource  types  having  SQTAG(K)  = 0. 

CUTIL: 

The  average  utilization  of  cutters.  In  ENDSIM,  this 
is  calculated  as  follows: 

NSTA 

CUTIL  = [ l UTIL (I)  ]/ [TIME  / REST(J,K)] 

IeL  J=1  KeM 
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CX30U: 
KOUNT : 


LIMIT: 


MCFTT: 


MEAND: 


where  L is  the  set  of  resources  having  SQTAGQYPE 
(I))  = 1 and  M is  the  set  of  resource  types  having 
SQTAG(K)  = l\ 

The  average  utilization  of  C-130's. 

During  the  simulation  KQUNT  is  the  number  of  cases 
currently  residing  in  core  storage.  At  the  end  of  the 
simulation  KOUNT  is  set  equal  to  the  sum  of  the  values 
NCAS  for  all  stations. 

During  the  simulation,  LIMIT  is  an  estimate  of  the 
maximum  number  of  cases  which  can  reside  in  core 
storage  simultaneously.  In  ENDSIM,  LIMIT  is  set 
equal  to  the  sum  of  the  values  NMBRQ  for  all  stations . 
The  average  Failure  type  C in  the  district  expressed 
in  decimal  hours.  This  is  calculated  in  Subroutine 
ENDSIM;  it  is  the  sum  of  all  the  positive  values  of 
(TWAIT-TOL)  in  the  district  multiplied  by  24  and  divided 
by  NBRFC. 

The  normalized  demerit  in  the  district.  It  is  an 
accumulation  of  all  the  case  demerits  during  the  simu- 
lation. In  ENDSIM,  its  is  replaced  with  (MEAND* 2 4.0*R)/ 

NSTA 

l NCAS (I)  where  R is  the  sum  of  all  positive  (TWAIT- 
1=1 

TOL)  in  the  district  divided  by  the  sum  of  all  case 
demerits  in  the  district. 
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MEANV:  The  average  TVEC  in  the  district  of  the  first  resource 

to  arrive  on  the  scene  of  a case.  It  is  an  accumulation 
of  these  times -to -vector  during  the  simulation.  In  ENDSIM, 

. v NSTA 

it  is  replaced  by  MEANV  *24.0/  J NCAS  (I). 

1=1 

MEANW:  The  average  time  that  a case  must  wait  prior  to  the  arrival 

of  the  first,  resource.  This  is  the  sum  of  the  values  of 
TWAIT  for  all  cases  multiplied  by  24  and  divided  by  the  sum 
of  the  values  NCAS  for  all  stations. 

MNTMT:  The  average  positive  (TWAIT-TOL)  in  the  district.  This  is 

the  sum  of  all  the  positive  values  of  (WAIT-TOL)  multiplied 
by  24  and  divided  by  the  sum  of  the  values  NCAS  for  all 
stations . 

NBRCO : The  number  of  cases  that  were  actually  completed. 

WBRCS:  The  total  number  of  cases  that  occurred. 

NBRFA, 

NBRFB, 

NBRFC:  Total  number  of  Failures  of  type  A,  B,  and  C,  respectively 

in  the  district.  These  are  the  sums  of  FAILl(STA),  FAIL2(STA) 
and  FAILS (STA)  respectively  taken  over  all  stations. 

SNEED:  The  total  number  of  needs.  This  is  the  sum  of  NEEDS (STA)  over 

all  stations.  This  may  not  equal  the  actual  number  of  needs 
that  occurred  since  any  need  served  by  more  than  one  resource 
(as  would  be  the  case,  for  example,  if  an  interrupt  occurs) 
is  counted  more  than  once. 
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TOSBY : The  total  number  of  tijnes  a standby  is  called.  This  is 

the  sum  of  NSTBY(STA)  over  all  stations. 

TOTIN:  The  total  number  of  interrupts.  This  is  the  sum  of 

NINTR(STA)  over  all  stations. 

TUNPR:  The  total  number  of  standbys  called  and  not  used.  This 

is  the  sum  of  UNPRO(STA)  over  all  stations. 

The  output  produced  by  OPSIM  is  of  two  basic  types,  the  "Report 
Output"  and  the  "Tape  Output"  containing  the  attributes  of  the  individual 
cases.  The  two  types  will  be  discussed  separately  below. 

The  Report  Output  consists  of  eight  different  divisions.  A sample 
of  the  Report  Output  received  when  OPSIM  is  run  with  PRTOT  = 0 is  given 
in  Figure  VI-2.  The  first  division  is  labeled  "Input  Conditions".  This 
is  the  output  produced  by  the  FORTRAN  Subroutine  JUMPER  described  in  part 
IV.  It  indicates  cahnges  from  a base  condition  in  the  Initialization  Deck 
which  were  made  for  the  current  run. 

The  second  division  is  labeled  "District  Statistics".  The  following 
entities  and  attributes  are  output  in  this  division:  NBRCS,  NBRCO,  NBRFA, 

NBRFB,  NBRFC,  TIME,  AVUTO,  AVUS  for  all  shifts,  AUT  for  all  resource 
types,  BUHL,  CUTIL,  C130U,  AIRU,  TOSBY,  and  TUNPR.  All  these  statistics 
are  labeled  by  the  output  with  a brief  but  reasonable  definition. 

The  third  division  is  labeled  "Station  Response".  There  is  a row  of 
print  for  every  station  in  the  district  being  simulated.  The  following 
list  will  indicate  the  correspondence  between  column  labels  and 
attribute  names. 
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FIGURE  VI -2  [Sample  Report  Output) 
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N 20  2.23%  3.46%  1.0536  4.05%  5.32%  14.91%  8.67%  5.30% 
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the  following  resources  were  busy  WHEN  the  simulation  ended  at 
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ISABEL 


ATTRIBUTE 


Number  of  Cases 

NCASCSTA) 

Number  of  Needs 

NEEDS  (STA) 

Failure  Type  A 

FAILl(STA) 

Failure  Type  B 

‘yt 

Failure  Type  C 

FAIL2  (STA) 
FAIL3(STA) 

Number  of  Q's 

NMBRQ  (STA) 

Total  Interrupted  Needs 

NINTR(STA) 

Average  TVEC  (Hours) 

VCTR(STA) 

Average  WAIT  (Hours) 

AVG  W (STA) 

Average  CFAIL  (WAIT -TOL)  (Hours) 

CFTT(STA) 

Average  Pos.  WAIT -TOL  (Hours) 

TWTOL (STA) 

Normalized  Demerit  (Hours) 

EMIT  (STA) 

Standbys  Calls/Unpro. 

NSTBY(STA),  UNPRO(STA) 

Average  Utilization 

USE  (STA) 

The  last  row  printed  in  this  division  is  labeled  ’’TOTAL/AVG’’.  Reading 
from  left  to  right  the  entries  in  this  row  are  KOUNT,  SNEED,  NBRFA, 
NBRFB,  NBRFC,  LIMIT,  TOTIN,  MEANV,  MEANW,  MCFTT,  MNTMT,  MEAND  , TOSBY, 
TUMPR,  and  AVUTO. 

’’Group  Response”  labels  the  fourth  division.  The  correspondence 
between  column  labels  and  attribute  names  follows. 


LABEL 

ATTRIBUTE 

Number  of  cases 
Number  of  needs 

CS (GROUP) 
NDS  (GROUP) 

Number  of  needs 
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Failure  Type  A 

FL1 (GROUP) 

Failure  Type  B 

FL  2 (GROUP) 

Failure  Type  C 

FL3 (GROUP) 

Total  Interrupted  Needs 

INTRP (GROUP) 

Average  TVEC  (Hours) 

WAVS  (GROUP) 

Average  TWAIT  (Hours) 

TVAVG (GROUP) 

Average  Pos.  TWAIT -TOL  (Hours) 

1MTAV  (GROUP) 

Normalized  Demerit 

AVDRT (GROUP) 

Times  Standby  Called 

NOSB (GROUP) 

Unporductive  Standby  Calls 

NONPR (GROUP) 

Average  Utilization 

USEAV (GROUP) 

The  fifth  division  is  labeled  "Resource  Utilization  (Percent)". 

Here  again  the  output  is  grouped  by  station.  The  columns  labeled 
"SHIFT1",  "SHIFT2",  etc.  contain  the  attribute  USHF(I,J)  for  the  station 
I and  shift  J.  Every  resource  assigned  to  the  station  is  listed  in  a 
group  according  to  resource  type;  the  average  utilization  UTIL  and  the 
number  of  needs  served  by  the  resource  NCASE  are  printed. 

The  sixth  division  is  labeled  "Exceptional  Cases".  It  prints  the 
major  attributes  of  all  cases  which  were  not  completely  processed  because 

of  some  unusual  circumstances.  The  value  of  ITOL (CASE)  which  is  among 

; / 

the  attributes  printed  gives  some  indication  of  the  reason  that  the 
case  was  termed  "exceptional"  and  was  filed  in  the  set  EXCS. 

The  seventh  division  is  broken  into  two  sections.  The  mean,  standard 
deviation  and  distribution  of  both  weekday  and  weekend  utilization  are 
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output  in  the  first  section.  In  the  second  section,  the  mean,  standard 
deviation  and  distribution  of  certain,  critical  attributes  are 
printed. 

The  eighth  and  final  division  prints  the  status  of  cases  which 
are  in  the  queue  and  are  not  completed  and  resources  which  are  still 
busy  when  the  simulation  ends.  The  following  attributes  are  labeled 
and  printed  for  cases  remaining  in  the  queue:  NOCAS,  OCCUR,  STATN,  NNN, 

MNM,  SIS,  S2S,  XC,  YC,  TINQ,  SIGN!  and  FLG.  If  there  are  no  remaining 
cases  in  the  queue,  a message  only  is  printed.  For  the  cases  being 
served  when  the  simulation  ends  the  following  attributes  are  labeled 
and  printed:  NOCAS,  OCCUR,  STAIN,  NNN,  WM,  SIS,  S2S,  XC,  YC,  and 

TWAIT.  The  case  attributes  here  refer  to  the  case  stored  in  ACASE 
(IFLT(IRS)),  that  is  the  case  to  which  the  resource  is  assigned.  It 
should  be  noted  here  that  TWAIT  is  zero  until  the  first  resource  arrives 
on  the  scene  of  the  case.  If  no  resources  are  busy  at  the  end  of  the 
simulation  a message  to  this  effect  is  printed. 

The  second  basic  type  of  output  has  been  referred  to  as  the  'Tape 
Output".  This  output  is  produced  only  if  the  value  of  STAPE  is  non- zero. 
If  the  value  of  STAPE  corresponds  to  a tape  unit,  a tape  must  be  requested 
by  the  appropriate  letter  on  an  ASG  control  card  as  described  in  part  V, 
User's  Guide.  Every  time  that  a case  terminates  via  completion  and  STAPE 
f 0,  Subroutine  TERM  outputs  the  major  attributes  of  the  case.  Four 
records  are  written  for  each  case.  The  contents  of  each  record  will  be 
given,  followed  by  the  SIMSCRIPT  format  as  well  as  a FORTRAN  format  for 
reading  the  records. 
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Record  1;  NBROO,  OPFAC,  NOCAS,  IDLOC,  OCCUR,  BOX,  FPRI,  MNM,  j m, 


GAMMA.,  NEED,  AIR,  OFSHR,  VIS,  WIND,  SWELL,  L,  FOB,  SIS,  S2S,  TSM, 

OST,  DMERT. 

SIMSCRIPT  Format;  (315,  13,  D3.4,  15,11,  212,  D3.2,  12,  15,  D4.2,  615, 

12,  D5.Q,  2D1.4). 

FORTRAN  Format : (315,  13,  F8.4,  15,  II,  212,  F6.2,  12,  15,  F7.2, 

615,  12,  F6,0,  2F6.4). 

y. 

Record  2:  UIYPE,  YAJJJE,  XCX,  Y&,  XC,  YC,  STAIN,  CNRES , RESA,  PRI, 

REA,  COSTC , ITOL,  NOINT,  NQUE,  TINT,  TQUE,  TQUE1,  TSVC,  TWAIT, 

SIMSCRIPT  Format:  (15,  110,  4D5.2,  15,  12,  13,  211,  D7.2,  II, 

212,  5D3.4). 

FORTRAN  Format:  (15,  110,  4F8.2,  15,  12,  13,  211,  F10.2,  II,  212, 

5F8.4) . 

Records  3 and  4 apply  to  NOTIF's  and  NOTE’S  respectively.  Four 
attributes  of  NOTIF  and  one  attribute  of  NOTE  are  always  output  for 
five  NOTIF’s  and  five  NOTE'S,  regardless  of  the  actaul  number  of 
NOTIF's  and  NOTE'S  associated  with  the  case.  If  there  are  less  than 
five  of  either,  the  meaningless  portion  of  the  record  will  contain 
zero's.  If  there  are  more  than  five  of  either,  only  the  "first"  five 
will  be  output.  "First"  refers  to  the  order  in  which  they  were  filed 
in  their  respective  sets  NSET  and  SRHS.  Hie  actaul  variables  are 
first  stored  in  a buffer  and  then  output. 

Record  3:  NEED,  OST,  DELTA,  RESA,  NEED,  OST,  DELTA,  RESA,  etc. 

SIMSCRIPT  Format:  (5(12,  D1.4,  D1.2,  13)). 

FORTRAN  Format:  (5(12,  F6.4,  F4.2  13)). 
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Record  4:  RESA,  RESA,  RESA,  RESA,  RESA. 


SXNgCRIPT  Format;  (513) . 

FORTRAN  Format:  (513) . 

It  should  be  noted  that  the  variable  NBRCO  output  in  record  1 simply 
provides  a sequence  number  for  the  cases  being  printed. 

At  the  end  of  the  simulation,  if  STATE  / 0,  the  four  records 
described  above  are  output  for  all  cases  filed  in  EXCS.  They  are 
printed  in  the  order  in  which  they  were  filed  in  EXCS.  It  should  be 
noted  that  all  information  for  NOTE  or  NOTIF  was  destroyed  when  the 
case  was  filed  in  EXCS.  Thus  the  third  and  fourth  records  for  these 
cases  will  always  be  zero  filled.  The  sequence  numbers  for  these 
cases  begins  with  the  value  NBRCO  + 1,  where  NBRGO  is  the  number  of 
cases  completed  at  the  end  of  the  simulation. 

There  is  one  significant  warning  message  which  could  occur 
during  the  execution  of  a simulation.  It  is  printed  in  Exogenous 
Event  OPSIM,  as  an  attempted  "Failsafe"  device  to  prevent  too  many 
cases;  from  entering  the  simulation  system  at  one  time,  thereby 
exceeding  core  storage  and  destroying  all  data  of  the  run  because  of 
an  abnormal  abort.  The  variable  KOUNT  is  increased  by  one  every 
time  a case  is  created  and  decreased  by  one  when  a case  is  destroyed. 

Thus  KOUNT  is  (during  the  simulation)  the  number  of  cases  currently 
being  processed  in  the  system.  A variable  LIMIT  is  calculated  in 
Exogenous  Event  START.  It  is  an  estimate  of  the  maximum  number  of 
Cases  which  can  reside  in  core  storage  at  one, time.  It  is  an  empirical 
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relation  based  on  the  number  of  resources  NRES,  the  number  of  stations 
NSTA,  the  number  of  resource  types  NRST,  the  number  of  groups  NGROUP  and 
the  number  of  distributions,  NDSTRB;  it  is  given  by:  - 

(10500.  - 10.  * NRES  - 19.  *NSTA  - 6.*  NRST  - 6.*  NGROUP  - 5.  *NDSTRB)/50. 
For  example,  with  109  resources,  47  stations,  16  resource  types,  8 groups 
and  12  distributions,  there  can  be  approximately  165  cases  in  the  system 
at  one  time.  It  should  be  emphasized  that  this  is  only  an  estimate 
which  could  be  revised  at  any  time. 

If  at  any  time  the  value  of  KOUNT  exceeds  the  value  of  LIMIT, 
the  warning  is  printed.  From  then  on,  cases  will  be  destroyed  as  soon 
as  they  occur.  Those  cases  already  in  the  system  at  the  time  the 
message  is  written  will  be  processed  until  completion. 
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